home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / ripterm.zip / RIPTERM.DOC < prev    next >
Text File  |  1993-07-15  |  230KB  |  5,143 lines

  1.      ┌──────────────────────────────────────────────────────────┐
  2.      │                                                          │░
  3.      │                  ──────────────────────                  │░
  4.      │                     RIPterm v1.54.00                     │░
  5.      │                  ──────────────────────                  │░
  6.      │                                                          │░
  7.      │                                                          │░
  8.      │                      July 14, 1993                       │░
  9.      │                                                          │░
  10.      │                                                          │░
  11.      │  Copyright (c) 1992-93, TeleGrafix Communications, Inc.  │░
  12.      │                   All Rights Reserved                    │░
  13.      │                                                          │░
  14.      └──────────────────────────────────────────────────────────┘░
  15.       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  16.  
  17.  
  18. ╔════════════════════════════════════════════════════════════════════╗
  19. ║                         1.0 ■ INTRODUCTION                         ║
  20. ╚════════════════════════════════════════════════════════════════════╝
  21.  
  22. Thank you for trying RIPterm!  A revolutionary new way of viewing
  23. on-line hosts.  This graphics based terminal program is the latest
  24. release of the RIPscrip graphical terminal program.
  25.  
  26. As a user of RIPterm, you should be aware of its licensing agreement.
  27. The following information details how, when and where RIPterm may be
  28. distributed.  Read this section very carefully.
  29.  
  30.  
  31. ┌────────────────────────────────────────────────────────────────────┐
  32. │                   1.1 ■ DISTRIBUTION INFORMATION                   │
  33. └────────────────────────────────────────────────────────────────────┘
  34.  
  35. You are free to distribute RIPterm to anyone you wish based upon the
  36. following terms and conditions.  RIPterm is FreeWare only in the
  37. sense that you may distribute it governed by the following
  38. restrictions: RIPterm may NOT be freely distributed as part of a
  39. commercial or ShareWare software package without written
  40. authorization from TeleGrafix Communications, Inc. ("TeleGrafix").
  41.  
  42. RIPterm may not be modified in any way without prior written consent
  43. from TeleGrafix.  There are two exceptions to the license that do not
  44. violate the license agreement.  They are:
  45.  
  46.     a) You may supply a RIPTERM.PCX file in 640x350 (16 color) format
  47.        which will be displayed while RIPterm is starting up.  The
  48.        purpose is to offer an advertising mechanism for your host.
  49.  
  50.        The lower 1/7th (50 scan lines) of the intro screen is
  51.        reserved for TeleGrafix's copyright information.  Altering of
  52.        the RIPTERM.EXE file to change the copyright violates this
  53.        license agreement and is a crime under copyright laws.
  54.  
  55.     b) You may also provide a dialing directory file (RIPTERM.PHO)
  56.        with your host telephone number entered in.
  57.  
  58. RIPterm may not be distributed unless accompanied by all of the
  59. following files (either in diskette or archive form):
  60.  
  61.     RIPTERM.EXE    <- The RIPterm executable program
  62.     RIPTERM.HLP    <- RIPterm help file
  63.     RIPTERM.DOC    <- RIPterm documentation (this file)
  64.     RIPTERM.FNT    <- RIPterm system font data file
  65.     RIPTERM.RES    <- RIPterm image resource file
  66.     RIPTERM.PCX    <- RIPterm logo file
  67.     WHATSNEW.DOC   <- Details new things in this release
  68.     DIALCONV.EXE   <- Dialing directory conversion utility
  69.     BOLD.CHR       <- Graphical Font (Bold Font)
  70.     EURO.CHR       <- Graphical Font (European Font)
  71.     GOTH.CHR       <- Graphical Font (Gothic Font)
  72.     LCOM.CHR       <- Graphical Font (Complex Font)
  73.     LITT.CHR       <- Graphical Font (Small Font)
  74.     SANS.CHR       <- Graphical Font (Sans Serif Font)
  75.     SCRI.CHR       <- Graphical Font (Script Font)
  76.     SIMP.CHR       <- Graphical Font (Simplex Font)
  77.     TRIP.CHR       <- Graphical Font (Triplex Font)
  78.     TSCR.CHR       <- Graphical Font (Triplex Script Font)
  79.  
  80.  
  81. If you choose the customization features mentioned previously when
  82. distributing RIPterm, you may provide the following files in addition
  83. to the files listed above:
  84.  
  85.     RIPTERM.PCX    <- Logo file to promote your host
  86.     RIPTERM.PHO    <- A "pre-configured" dialing directory file
  87.     <icon files>   <- Icon files for your host
  88.  
  89.  
  90. ┌────────────────────────────────────────────────────────────────────┐
  91. │                       1.2 ■ LIMITED WARRANTY                       │
  92. └────────────────────────────────────────────────────────────────────┘
  93.  
  94. THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  95. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
  96. IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR
  97. PURPOSE.  TELEGRAFIX COMMUNICATIONS, INC. DOES NOT WARRANT THAT THE
  98. FUNCTIONS CONTAINED IN THIS SOFTWARE WILL MEET YOUR REQUIREMENTS OR
  99. THAT THE OPERATION OF THIS SOFTWARE WILL BE UNINTERRUPTED OR ERROR-
  100. FREE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  101. SOFTWARE IS WITH THE USER.  SHOULD THE SOFTWARE PROVIDED BE DEFECTIVE,
  102. YOU (NOT TELEGRAFIX COMMUNICATIONS, INC.) ASSUME THE ENTIRE COST OF
  103. ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
  104.  
  105. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE
  106. ABOVE EXCLUSION MAY NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU
  107. SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY
  108. FROM STATE TO STATE.
  109.  
  110. IN NO EVENT WILL TELEGRAFIX COMMUNICATIONS, INC. BE LIABLE TO YOU FOR
  111. ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  112. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  113. INABILITY TO USE THE SOFTWARE EVEN IF TELEGRAFIX OR ITS AUTHORIZED
  114. REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES,
  115. OR FOR ANY CLAIM BY ANY OTHER PARTY.
  116.  
  117. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR
  118. INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR
  119. EXCLUSION MAY NOT APPLY TO YOU.
  120.  
  121. YOU MAY NOT SUBLICENSE, ASSIGN OR OTHERWISE TRANSFER THIS LICENSE OR
  122. SOFTWARE EXCEPT AS EXPRESSLY PROVIDED IN THIS AGREEMENT.  ANY ATTEMPT
  123. TO OTHERWISE SUBLICENSE, ASSIGN, OR TRANSFER ANY OF THE RIGHTS,
  124. DUTIES OR OBLIGATIONS HEREUNDER IS EXPRESSLY PROHIBITED AND WILL
  125. TERMINATE THIS AGREEMENT.
  126.  
  127. BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE
  128. READ THIS AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS
  129. TERMS AND CONDITIONS.  YOU FURTHER AGREE THAT IT IS THE COMPLETE AND
  130. EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US, WHICH SUPERSEDES ANY
  131. PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER
  132. COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS
  133. AGREEMENT.
  134.  
  135.  
  136. ┌────────────────────────────────────────────────────────────────────┐
  137. │                         1.3 ■ REQUIREMENTS                         │
  138. └────────────────────────────────────────────────────────────────────┘
  139.  
  140. RIPterm requires that you be using an IBM-PC compatible computer
  141. system running MS-DOS version 3.0 or higher.  You must have 430K of
  142. available RAM or more.  A hard disk is strongly recommended.  You
  143. must have an EGA or higher video adapter and a modem connected to
  144. serial port COM1 through COM4.  A mouse and a color monitor are not
  145. required, but are strongly recommended.  This software does not
  146. require Extended (XMS) or Expanded (EMS) memory, but can take
  147. advantage of either if present to improve software performance.
  148.  
  149.  
  150. ┌────────────────────────────────────────────────────────────────────┐
  151. │                    1.4 ■ IMPORTANT INFORMATION                     │
  152. └────────────────────────────────────────────────────────────────────┘
  153.  
  154. Complications may arise currently if you have a SERIAL mouse
  155. installed instead of a BUS mouse.  If you get garbage on the screen
  156. when you move the mouse, then there is a conflict with the MODEM port
  157. and the MOUSE port.  Try deleting the RIPTERM.CNF (RIPterm's
  158. configuration file) and restarting RIPterm.  Once inside RIPterm,
  159. press ALT-O (for Options) and verify that your settings are correct
  160. for your PC's configuration.
  161.  
  162. See APPENDIX A - TROUBLESHOOTING (Section A.2) for more details on
  163. this issue.
  164.  
  165.  
  166. ┌────────────────────────────────────────────────────────────────────┐
  167. │                         1.5 ■ INSTALLATION                         │
  168. └────────────────────────────────────────────────────────────────────┘
  169.  
  170. Create a directory on your hard disk called RIPTERM.  Under that
  171. directory, create another directory called ICONS and a second one
  172. called FONTS.  For example:
  173.  
  174.     md \RIPTERM
  175.     md \RIPTERM\ICONS
  176.     md \RIPTERM\FONTS
  177.  
  178. Copy all .ICN, .MSK, and .HIC files into the ICONS directory.  Copy
  179. all .CHR files into the FONTS directory and all remaining files into
  180. the RIPTERM directory.  Type RIPTERM to start up the software.  It
  181. will ask you which port your modem is connected to, the baud rate to
  182. use and what printer port your printer is connected to (if any).
  183.  
  184. If you forget to perform any of these steps, or you UNZIP RIPterm
  185. from the distribution archive without extracting sub-directory info,
  186. RIPterm will accommodate the oversight by prompting you to copy
  187. the necessary icon files over to the correct ICONS\ and/or FONTS\
  188. directories.
  189.  
  190.  
  191. ╔════════════════════════════════════════════════════════════════════╗
  192. ║                        1.6 ■ THINGS TO KNOW                        ║
  193. ╚════════════════════════════════════════════════════════════════════╝
  194.  
  195. RIPterm may have been accompanied by a number of icon files.  If so,
  196. they must be located in the ICONS\ directory.  We recommend that you
  197. install RIPterm into a directory called RIPTERM.  The ICONS\
  198. directory would be located under the terminal directory as in the
  199. following example: C:\RIPTERM\ICONS.  All icon files end in an
  200. extension of .ICN, .MSK or .HIC.  If the icons are not located in the
  201. ICONS\ directory, then RIPterm will not load them when instructed to
  202. do so.  RIPterm will try to sense if the icons are easily locatable,
  203. and if so, prompt you to move them to the correct location when you
  204. run RIPterm.
  205.  
  206. There are also ten separate graphical font files that are included
  207. with RIPterm.  Like the Icon files, they too need to be located in
  208. their own sub-directory.  All font files end in a .CHR file extension
  209. and should be located in the FONTS\ sub-directory under your RIPterm
  210. directory.
  211.  
  212. If you make a mistake and try to boot-up RIPterm with fonts or icons
  213. in the current RIPterm directory, the software will prompt you to
  214. move the files over to the proper directories.  You may choose to let
  215. RIPterm do this for you automatically.  If you instruct RIPterm not
  216. to move the files, you will receive the message about files being
  217. in the wrong place each time you load RIPterm until the problem is
  218. taken care of.
  219.  
  220.  
  221. ┌────────────────────────────────────────────────────────────────────┐
  222. │                      1.7 ■ GLOSSARY OF TERMS                       │
  223. └────────────────────────────────────────────────────────────────────┘
  224.  
  225. host - refers to the system you are connected to.  This can be a BBS,
  226.        a mainframe, a network application, whatever.
  227.  
  228. icon - an icon is a bit map graphic of varying size.  Icon files may
  229.        end in .ICN, .MSK (mask files), or .HIC (hot icons - used with
  230.        buttons)
  231.  
  232.  
  233. ┌────────────────────────────────────────────────────────────────────┐
  234. │                          1.8 ■ TRADEMARKS                          │
  235. └────────────────────────────────────────────────────────────────────┘
  236.  
  237. RIPterm, RIPscrip, RIPaint, the RIPterm logo, TeleGrafix
  238. Communications, and the TeleGrafix Communications logo are all
  239. trademarks of TeleGrafix Communications, Inc.
  240.  
  241. All other trademarks are trademarks of their respective holders.
  242.  
  243.  
  244. ╔════════════════════════════════════════════════════════════════════╗
  245. ║                     2.0 ■ PROGRAM INFORMATION                      ║
  246. ╚════════════════════════════════════════════════════════════════════╝
  247.  
  248. RIPterm has a number of features which make it a useful terminal
  249. program.  Among the features are the following:
  250.  
  251.     ■ RIPscrip graphics viewing ability
  252.     ■ Graphics mode operation - 16-color, 640x350 resolution
  253.     ■ Scrollback mode to review text transmitted from host
  254.     ■ Editable Keystroke Macros with load/save ability
  255.     ■ Log-to-Disk ability
  256.     ■ Printer-Log ability
  257.     ■ Full ANSI support (plus some VT-102 and VT-52 support)
  258.     ■ Supports COM1 through COM4
  259.     ■ Custom IRQ and base I/O address settings
  260.     ■ Context sensitive, keyword driven help system
  261.     ■ Pull-down menu operation as well as complete hot-key support
  262.     ■ Fully configurable modem settings
  263.     ■ Auto-redial feature
  264.     ■ Auto-answer mode
  265.     ■ Batch upload/download ability
  266.     ■ Auto Z-Modem downloads
  267.     ■ Upload ASCII files with optional line/character pacing
  268.     ■ Shell to DOS capability
  269.     ■ EMS/XMS overlay support to maximize memory efficiency
  270.     ■ Local external Application system - run favorite programs from
  271.       inside RIPterm.
  272.     ■ Simplified software setup
  273.     ■ Shell to EMS/XMS/Disk for maximum memory usage in a DOS Shell
  274.  
  275.  
  276. ┌────────────────────────────────────────────────────────────────────┐
  277. │                     2.1 ■ GETTING ON-LINE HELP                     │
  278. └────────────────────────────────────────────────────────────────────┘
  279.  
  280. The help system of RIPterm is easy to use.  Simply hit F1 for help.
  281. To return to the Table of Contents at any time, click on the
  282. "Contents" button at the bottom of the screen.  If you have navigated
  283. through various help screens, you can back-up to the previous screen
  284. by clicking on the "Back" button.  Any words or phrases which are
  285. highlighted (light blue on color monitors) are "keywords" which you
  286. can click on to jump to that help topic.  You may use the
  287. UP/DOWN/LEFT/RIGHT keys to navigate through the help screen's
  288. keywords, or you may use the TAB or SHIFT-TAB to highlight different
  289. keywords.  Tap <ENTER> and the currently selected keyword will be
  290. selected, and you will be taken to that help screen.
  291.  
  292. The Help System Table of Contents may also be accessed by clicking on
  293. "F1=help" in the Status Bar.
  294.  
  295.  
  296. ┌────────────────────────────────────────────────────────────────────┐
  297. │                       2.2 ■ STARTING RIPTERM                       │
  298. └────────────────────────────────────────────────────────────────────┘
  299.  
  300. There are a number of options that you may choose from when starting
  301. up RIPterm.  These options are specified as "parameters" on the DOS
  302. command line.  Each option is preceded with either a hyphen (-) or a
  303. forward slash (/).  Each option is described below:
  304.  
  305.     -N         ... Suppress the intro screen
  306.     -M         ... Disables all mouse activity
  307.     -O         ... Indicate you are already on-line (don't init modem)
  308.     -E         ... Disable extended keyboard support
  309.     -Z         ... Disable zooming windows
  310.     -D<entry#> ... Dial <entry#> upon start up (from 1-100)
  311.     -P<file>   ... Use an alternate phone directory file
  312.     -R<file>   ... Play-back .RIP file upon start up
  313.     -S<file>   ... Use an alternate setup file
  314.  
  315. Command line options are not case sensitive.  You may specify these
  316. options together (for single character options), or as separate
  317. parameters on the command line.  For example, to suppress the intro
  318. screen, disable zooming windows and indicate that you are already
  319. on-line, you could execute the following DOS command:
  320.  
  321.     RIPTERM -noz
  322.  
  323. Each of these options are described more fully in the following
  324. sub-sections:
  325.  
  326. ┌──────────────────────────────────┐
  327. │ -N ... Suppress the Intro Screen │
  328. └──────────────────────────────────┘
  329.  
  330. When you choose this option, the start up logo screen is disabled.
  331. You will be placed directly into RIPterm's session screen providing
  332. there are no configuration problems, or other questions that RIPterm
  333. must ask you in order to run properly.
  334.  
  335. ┌────────────────────────────────────┐
  336. │ -M ... Disables all Mouse Activity │
  337. └────────────────────────────────────┘
  338.  
  339. When you choose this option, RIPterm will not check for a mouse.  In
  340. fact, regardless of whether or not a mouse is installed, RIPterm will
  341. not use it.  Generally speaking, you will probably never need to use
  342. this option unless you find that RIPterm doesn't operate properly
  343. with your mouse.
  344.  
  345. ┌────────────────────────────────────────────────────────────┐
  346. │ -O ... Indicate you are already on-line (don't init modem) │
  347. └────────────────────────────────────────────────────────────┘
  348.  
  349. When you choose this option, RIPterm will not initialize the modem
  350. for you (if your default mode is "modem connection" mode).  If you
  351. are in this state, RIPterm will simply start up and press the <ENTER>
  352. key.  This is done to (ideally) display some kind of prompt on the
  353. host for you (or at least something). Note that RIPterm will
  354. auto-sense if you are already on-line and do this for you if it
  355. detects you're on-line.  This only applies to modem connection mode.
  356.  
  357. If you are in non-modem connection mode and you specify this
  358. option, RIPterm will start up and do absolutely nothing.  It will
  359. not press the <ENTER> key for you.  It will simply enter the
  360. session screen and sit there waiting for you to do something.
  361.  
  362. ┌──────────────────────────────────────────┐
  363. │ -E ... Disable extended keyboard support │
  364. └──────────────────────────────────────────┘
  365.  
  366. This option is primarily for use when you are trying to troubleshoot
  367. the "doorway mode".  Doorway mode will take advantage of a 101-key
  368. enhanced AT computer keyboard.  If you enable 101-key keyboard mode,
  369. and you do not have a 101-key keyboard (or RIPterm doesn't think you
  370. have one), RIPterm might lock-up.  If you inadvertently saved this to
  371. the setup, the next time RIPterm starts up, it could freeze up on you
  372. when you enter doorway mode again.  In this case, use this start up
  373. option to "override" 101-key keyboard mode so that you can disable it
  374. and fix things for normal operation. This option should almost never
  375. be necessary except in troubleshooting situations.
  376.  
  377. ┌────────────────────────────────┐
  378. │ -Z ... Disable Zooming Windows │
  379. └────────────────────────────────┘
  380.  
  381. This option will disable the zooming windows feature of RIPterm for
  382. the duration of the current RIPterm session.  This mode overrides the
  383. setup option for zooming windows.  If you select Save Setup from the
  384. Modem menu, this override will become permanent (until changed and
  385. saved).  Some people find the zooming windows feature annoying in
  386. that it slows down operation of opening and closing windows a little
  387. bit.  For these power users, you may use this option, or simply save
  388. the zoom windows off setting to your setup.
  389.  
  390. ┌─────────────────────────────────────────────────────────┐
  391. │ -D<entry#> ... Dial <entry#> upon start up (from 1-100) │
  392. └─────────────────────────────────────────────────────────┘
  393.  
  394. This option will instruct RIPterm to automatically dial a particular
  395. entry in the dialing directory immediately after it initializes the
  396. Modem (if necessary).  Whether or not the connection can be
  397. established or not is unimportant, RIPterm will remain active
  398. regardless.  Use this option from within a batch file if you
  399. frequently start up RIPterm and need to dial a particular number. You
  400. may specify a dialing directory entry from 1-100.  An example of
  401. using this option is as follows:
  402.  
  403.               RIPTERM -D15
  404.  
  405. The above example starts up RIPterm and places a call to dialing
  406. directory entry #15 just as if you had selected it manually.
  407.  
  408. ┌────────────────────────────────────────────────────┐
  409. │ -P<file> ... Use an alternate Phone Directory file │
  410. └────────────────────────────────────────────────────┘
  411.  
  412. This option instructs RIPterm to load a dialing directory file other
  413. than RIPTERM.PHO upon start up.  This option is useful if you
  414. frequently use a special dialing directory file for certain
  415. applications.  This option can be used with the command line option
  416. to automatically dial a directory entry upon start up.  In other
  417. words, you can combine the -P and -D parameters together on the same
  418. command as in the following example:
  419.  
  420.                     RIPTERM -Pmyfile.pho -D3
  421.  
  422. The above example would load RIPterm, load the directory file called
  423. MYFILE.PHO, initialize the modem, then automatically dial entry
  424. number 3 in the MYFILE.PHO dialing directory file.
  425.  
  426. ┌────────────────────────────────────────────────┐
  427. │ -R<file> ... Play-back .RIP file upon start up │
  428. └────────────────────────────────────────────────┘
  429.  
  430. This option allows you to execute a local .RIP file upon initial
  431. start up of RIPterm.  This allows you to draw some graphics, or even
  432. set up a screen with modem configuration mouse buttons.  This allows
  433. for a great deal of flexibility.  This option also serves as a good
  434. mechanism to test RIPscrip graphics for the RIPaint/RIPdraw artist.
  435.  
  436. ┌──────────────────────────────────────────┐
  437. │ -S<file> ... Use an alternate setup file │
  438. └──────────────────────────────────────────┘
  439.  
  440. This option allows you to specify an alternate RIPterm setup file
  441. upon start up.  By default, RIPterm will load RIPTERM.CNF (or create
  442. one if necessary).  Use this option if you frequently start up in a
  443. particular configuration (e.g., using a COM port other than the
  444. standard default port that is recorded in RIPTERM.CNF). This option
  445. may be combined with any other command line parameter for RIPterm as
  446. in the following example:
  447.  
  448.     RIPTERM -nz -Pmyfile.pho -Smysetup.cnf -D10
  449.  
  450. The above example suppresses the intro logo screen, instructs RIPterm
  451. not to use zooming windows, loads the dialing directory file
  452. MYFILE.PHO, loads configuration file MYSETUP.CNF and automatically
  453. dials directory entry #10 upon start up.  This is about as complex of
  454. a start-up example as you can get.  This is typically nothing like
  455. what you would ever use with RIPterm unless you are what is commonly
  456. referred to as a "Power User", whereby this stuff would be old hat to
  457. you anyway.
  458.  
  459.  
  460. ┌────────────────────────────────────────────────────────────────────┐
  461. │                      2.3 ■ HELP ON THE MENUS                       │
  462. └────────────────────────────────────────────────────────────────────┘
  463.  
  464. Selecting the "Pull-Down Menu Help" option from the PROJECT menu
  465. allows you to view help information on the various menu options.  A
  466. window will appear instructing you to select a pull-down menu option
  467. for help.  Simply click on the right mouse button and pull down the
  468. desired menu.  Select an option, and a Help Screen will appear on
  469. that item.  When finished, press the <ESC> key to exit "Menu Help"
  470. mode.  You may also select menu options via the keyboard by using the
  471. F10 key to activate the menu system.
  472.  
  473.  
  474. ┌────────────────────────────────────────────────────────────────────┐
  475. │                       2.4 ■ PULL-DOWN MENUS                        │
  476. └────────────────────────────────────────────────────────────────────┘
  477.  
  478. To activate the pull down menus, move the mouse pointer to the top of
  479. the screen and press and hold down the right mouse button.  A menu
  480. bar will appear at the top of the screen.  Move the mouse pointer to
  481. any of these items and a list of menu options will appear below the
  482. menu bar.  At this point, move the mouse down into this list of items
  483. and as you move over different items, they will be highlighted.  To
  484. select any given item, release the right mouse button while the
  485. desired option is highlighted.
  486.  
  487. You may access the menu system without the mouse by pressing the F10
  488. key.  When selected, the menu bar will appear with one of the menu
  489. items highlighted.  Use the RIGHT and LEFT keys to highlight the
  490. desired menu item, then press the PGDN, DOWN or ENTER keys to display
  491. a list of menu contents for the specified topic.  Use the UP/DOWN
  492. keys to highlight a particular item in the list.  The HOME and END
  493. keys work as you would expect them to.  While a menu is displayed
  494. completely, you may use the LEFT and RIGHT arrow keys to move to an
  495. adjacent menu topic. Pressing PGUP or ESC while a menu is displayed
  496. will remove the list of menu options, and return you to the menu bar
  497. only.  Pressing ESC again will terminate the menu bar mode and return
  498. you to your RIPterm session. If you select options while accessing
  499. the menu with the keyboard, when the option is finished executing,
  500. you will be returned to the pull-down menu so that you can execute
  501. other options quickly.
  502.  
  503. All options in the pull down menus have corresponding hot-keys that
  504. you can use.  Hot-keys are keyboard short cuts for menu options.
  505. Hot-keys make it so that you do not have to use the mouse to access
  506. the menu.
  507.  
  508. Some menu options are "toggle" items.  If an option is toggled ON,
  509. then you will see a check-mark beside the option indicating that it
  510. is active.  Select these options to toggle the state ON or OFF.
  511.  
  512.  
  513. The remaining portion of this section describes each menu, and how
  514. each option functions.
  515.  
  516.  
  517. ┌────────────────────────────────────────────────────────────────────┐
  518. │                     2.4.1 ■ THE "PROJECT" MENU                     │
  519. └────────────────────────────────────────────────────────────────────┘
  520.  
  521. This menu contains many general RIPterm functions:
  522.  
  523. ┌───────────────┐
  524. │ ABOUT RIPTERM │
  525. └───────────────┘
  526.  
  527. This option will display a help screen displaying the copyright
  528. information for RIPterm.
  529.  
  530. ┌─────────────┐
  531. │ SYSTEM INFO │
  532. └─────────────┘
  533.  
  534. This option will display the amount of RAM memory currently available
  535. as well as the amount of disk space free on the currently selected
  536. hard disk.
  537.  
  538. ┌─────────────┐
  539. │ HELP SYSTEM │
  540. └─────────────┘
  541.  
  542. This option will display the help system's Table of Contents.
  543.  
  544. ┌───────────────┐
  545. │ HELP ON MENUS │
  546. └───────────────┘
  547.  
  548. This option will allow you to view help information on the menus.  A
  549. window will appear instructing you to select a menu option.  Depress
  550. the right mouse button and pull down the desired menu.  Select an
  551. option, and a help screen will appear for that item.  When finished,
  552. press <ESC> to exit "Menu Help" mode.
  553.  
  554. ┌───────────────┐
  555. │ OPEN LOG FILE │
  556. └───────────────┘
  557.  
  558. A log file captures text transmitted from the host into a text file.
  559. ANSI color codes and RIPscrip graphics commands are filtered out for
  560. your convenience.  This command can be very powerful on hosts where
  561. you want to save data coming across the screen to a file that you can
  562. read when off-line, at your leisure.  A log file can be as big as you
  563. want, subject to the amount of currently available disk space.
  564.  
  565. To open a log file, select "Open Log File" from the menu.  You will
  566. be prompted for a filename.  When a log file is open, the menu option
  567. "Open Log File" changes to "Pause/Close Log" and the status bar will
  568. show the log file name in the third spot from the left, where the
  569. terminal emulation is normally displayed.
  570.  
  571. If a log file is currently open, selecting "Pause/Close Log" from the
  572. menu, or clicking on the filename in the status bar will give you the
  573. option to either pause the log, or to close the file.  Pausing
  574. "suspends" logging to disk temporarily so that you can do things
  575. without saving them to the log file.  If you are currently paused,
  576. selecting "Pause/Close Log" again or clicking on the filename in the
  577. status bar will prompt you to either resume, or close the log.
  578.  
  579. If a log file is open, and you choose EXIT RIPTERM, it will be
  580. closed automatically.
  581.  
  582. ┌─────────────┐
  583. │ JUMP TO DOS │
  584. └─────────────┘
  585.  
  586. The "Jump to DOS" feature allows you to shell out to an MS-DOS
  587. command line while remaining in RIPterm.  You would use this if you
  588. wanted to obtain a DOS directory, or to run an editor, or use DOS in
  589. general.  To return to RIPterm from the DOS command line, type
  590. "EXIT".
  591.  
  592. RIPterm will display a special DOS prompt indicating that are
  593. currently running RIPterm, but executing a DOS shell.  You may use
  594. any disk drive you want, or change directories.  When you type
  595. "EXIT", RIPterm will return to your default RIPterm directory so that
  596. it can re-load files for you.  When you return to your RIPterm
  597. session, the current graphics screen is restored as well as any mouse
  598. fields, or other parameters.
  599.  
  600. See the section on external applications for more details about the
  601. DOS Shell feature.
  602.  
  603. ┌──────┐
  604. │ EXIT │
  605. └──────┘
  606.  
  607. This exits RIPterm and return you to DOS.  If your modem
  608. configuration is set to "modem dialing", and you are currently
  609. on-line, a dialog box will appear asking if you wish to hang-up
  610. before exiting.  If you choose NO at this prompt, you will remain
  611. on-line even after you have exited to DOS.  Use this option with
  612. caution, as if you forget that you are on-line, you could charge up a
  613. considerable long distance bill.
  614.  
  615.  
  616. ┌────────────────────────────────────────────────────────────────────┐
  617. │                     2.4.2 ■ THE "OPTIONS" MENU                     │
  618. └────────────────────────────────────────────────────────────────────┘
  619.  
  620. This menu contains many options that can be used to alter RIPterm's
  621. basic mode of operation:
  622.  
  623. ┌─────────────┐
  624. │ STATUS LINE │
  625. └─────────────┘
  626.  
  627. The status line displays various important information about the
  628. current State of RIPterm.  Information displayed left to right:
  629.  
  630.     ┌───────────┬─────────────┬──────────┬─────────────────┬
  631.     │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
  632.     └───────────┴─────────────┴──────────┴─────────────────┴
  633.          (1)          (2)          (3)      (4)      (5)
  634.  
  635.     ┬──────┬──────────────────┬─────────┐
  636.     │ COM1 │ RIPterm v1.54.00 │ Offline │
  637.     ┴──────┴──────────────────┴─────────┘
  638.       (6)           (7)           (8)
  639.  
  640.     (1) How to get the help system table of contents
  641.  
  642.     (2) How to use the keyboard only to select from the menus
  643.  
  644.     (3) What terminal emulation is in use, or the name of the log
  645.         file if one has been opened, or the LPT port that it being
  646.         printed to.
  647.  
  648.     (4) The baud rate, parity setting, data bits and stop bits
  649.  
  650.     (5) Full-duplex (FDX) or half-duplex (HDX) settings
  651.  
  652.     (6) The COM port that is currently in use
  653.  
  654.     (7) The current version number of RIPterm
  655.  
  656.     (8) Whether you are "on-line" or "off-line"
  657.  
  658. To display or hide the status line, press ALT-SPACE.
  659.  
  660. ┌────────────────┐
  661. │ BUTTON HOTKEYS │
  662. └────────────────┘
  663.  
  664. A new option is available to the RIPterm user: Button hotkey release
  665. mode.  This allows the user to determine whether his keystrokes
  666. should be checked with the BBS buttons or not for activation.  In
  667. other words, if the BBS places a button on the screen like this:
  668.  
  669.                   ┌────────────────┐
  670.                   │                │
  671.                   │  (E)nter name  │
  672.                   │                │
  673.                   └────────────────┘
  674.  
  675. ...where the hotkey for the button is "E", simply pressing the "E"
  676. key on your keyboard would normally activate this button.  This may
  677. not be desirable if you're trying to send a message to another user
  678. with the letter "E" in it.  Now, there's a way around this: Hotkey
  679. Release Mode.
  680.  
  681. Hotkey Release mode is linked to your SCROLL-LOCK key on your
  682. keyboard.  If Scroll Lock is lit, then hotkeys are processed.  If it
  683. is not lit, then the character will be sent to the BBS directly,
  684. bypassing any button hotkeys.
  685.  
  686. ┌──────────────┐
  687. │ DOORWAY MODE │
  688. └──────────────┘
  689.  
  690. This mode is of use on a number of host packages that take advantage
  691. of "Doors".  When in Doorway mode, any keystroke that you enter on
  692. your keyboard is transmitted to the host regardless of the fact that
  693. the keystroke might be a menu shortcut, or something that RIPterm
  694. would normally process locally.  This allows you to use special
  695. keystrokes (like INSERT, DELETE, PGUP, Function Keys, etc.) on a host
  696. program that can take advantage of it. The most popular program that
  697. takes advantage of this mode is DOORWAY (tm) by Marshall Dudley.
  698.  
  699. RIPterm's support for Doorway operation is a complete implementation
  700. of the Doorway interface.  It fully supports the Printer Re-direction
  701. feature as well as Special Character Overiding for non-printable
  702. ASCII characters (control characters).  RIPterm v1.54 is one of the
  703. first terminals to be released to the general "market" with complete
  704. Doorway support.
  705.  
  706.     PROGRAMMER'S NOTE
  707.     -----------------
  708.       For the technical minded who want to know how this works,
  709.       this is what's going on:
  710.  
  711.         ■ The keystroke is recorded using BIOS interrupt
  712.           0x16, sub-function 0x00 for non-101-key keyboards,
  713.           or sub-function 0x10 for 101-key keyboards.
  714.  
  715.         ■ If register AL contains a value (the ASCII
  716.           character), and AH is equal to 0, then it is
  717.           sent to the host by transmitting the character
  718.           directly over the comm port (e.g., 'A', 'z', '3',
  719.           etc).
  720.  
  721.         ■ If AH is not 0, then transmit the contents of AH
  722.           instead to the host by transmitting a null (0),
  723.           then the contents of AH.  If AL == E0, and AH != 0,
  724.           then it is an enhanced 101-key scancode and should
  725.           be sent to the host as a null (0), followed by an
  726.           0xE0, then followed by the raw scan code (AH).
  727.  
  728. ┌─────────────┐
  729. │ PRINTER LOG │
  730. └─────────────┘
  731.  
  732. By toggling this option ON, your current online session will be
  733. echoed to your local printer (if any).  Any ANSI/ASCII text that is
  734. displayed on your screen will also be sent to your local printer on
  735. whatever Printer Port (LPT) you have configured RIPterm to use.  If
  736. RIPterm has not been configured for a printer, then this option will
  737. not operate (it will refuse to print).  When this mode is active, you
  738. will see a message on the status bar saying "--LPT1--" or whatever
  739. port you have configured for your printer.  Simply clicking on this
  740. field in the status bar will turn off printer log mode.
  741.  
  742. ┌───────────────────────┐
  743. │ CLEAR GRAPHICS WINDOW │
  744. └───────────────────────┘
  745.  
  746. RIPterm uses two windows in RIPscrip graphics mode, a graphics window
  747. and a text window.  The text window is where all non-graphical data
  748. is displayed.  The graphics window is where all graphical RIPscrip
  749. commands are displayed.
  750.  
  751. Choose this option to clear the graphics window only.  If the
  752. graphics window overlaps the text window, then some of the text may
  753. be erased in the process.  The window is cleared to the current
  754. background color, which by default is BLACK.
  755.  
  756. NOTE: The graphics window is ALWAYS set to the full screen in this
  757.       version of RIPterm (v1.54.00).
  758.  
  759. ┌───────────────────────┐
  760. │ CLEAR THE TEXT WINDOW │
  761. └───────────────────────┘
  762.  
  763. RIPterm uses two windows in RIPscrip graphics mode, a graphics window
  764. and a text window.  The graphics window is where all graphical
  765. RIPscrip commands are displayed.  The text window is where all
  766. non-graphics data is displayed.
  767.  
  768. Choose this option to clear the text window only.  If the text window
  769. overlaps the graphics window, then some of the graphics may be erased
  770. in the process.  The window is cleared to BLACK and the cursor moved
  771. to the upper left corner of the window.
  772.  
  773. NOTE: The text window, by default, is full screen.  This may be
  774.       changed by RIPscrip graphics commands.
  775.  
  776. ┌───────────────────┐
  777. │ RESET ALL WINDOWS │
  778. └───────────────────┘
  779.  
  780. This command will reset the text and graphics windows to full
  781. screen.  In addition, the screen is cleared and the cursor moved to
  782. the upper left hand corner of the screen.  This is equivalent to a
  783. clear screen command in other software packages.  The color palette
  784. is reset to the standard 16 ANSI colors, the font is reset to the
  785. system default you have selected and any mouse fields/buttons are
  786. deleted from the screen.
  787.  
  788. ┌────────────────────────┐
  789. │ VIEW SCROLLBACK BUFFER │
  790. └────────────────────────┘
  791.  
  792. This option will activate the text scrollback system.  This allows
  793. you to view previously displayed text information that has come
  794. across the modem.  You may set the scrollback buffer size to 5k - 64k
  795. of memory.
  796.  
  797. Within scrollback, you may choose from the following options:
  798.  
  799.              SAVE buffer page to a text file
  800.              SAVE entire buffer to a text file
  801.             PRINT the current buffer page, or the entire buffer
  802.            SEARCH for a particular piece of text
  803.      SEARCH AGAIN for a previously searched for text string
  804.  
  805. At the top of the scrollback screen are buttons for the above
  806. commands.  In addition, there are buttons for scrolling up and down,
  807. paging up and down, or moving to the beginning or end of the buffer.
  808.  
  809. NOTE: The scrollback buffer filters out ANSI color codes and
  810.       RIPscrip graphics for an uncluttered text display.
  811.  
  812. ┌────────────────────────┐
  813. │ KEYSTROKE MACRO EDITOR │
  814. └────────────────────────┘
  815.  
  816. Macros are functions that you can define to perform short-cut
  817. operations on the host.  For example, you can instruct RIPterm to
  818. make the F5 key type your User-ID and press <ENTER> for you.  This
  819. would allow you to log-on quickly by simply pressing a single key.
  820. RIPterm's macro system is easy to use, and very powerful!  You can
  821. save your macro keys to the default macro file (RIPTERM.KEY), or if
  822. you need to have multiple macro configurations, you can save macros
  823. to different files.
  824.  
  825. ┌─────────────┐
  826. │ SYSTEM FONT │
  827. └─────────────┘
  828.  
  829. The System Font allows you to select the font that is used in the
  830. text/ANSI mode.  It does not have any effect on the graphics shown.
  831. Any subsequent text/ANSI displayed on the screen will appear in the
  832. chosen system font unless the host explicitly tells RIPterm to use
  833. another font for the text window.
  834.  
  835. This mode allows you to specify how "large" text is when you are in
  836. full-screen text mode.  You have five separate System Fonts to choose
  837. from.  They are:
  838.  
  839.         80x43 - default
  840.         80x25 - normal DOS screen size
  841.         40x25 - low-resolution font
  842.         91x43 - get more columns of text at once
  843.         91x25 - get more columns of text at once
  844.  
  845.  
  846. ┌────────────────────────────────────────────────────────────────────┐
  847. │                      2.4.3 ■ THE "MODEM" MENU                      │
  848. └────────────────────────────────────────────────────────────────────┘
  849.  
  850. The Modem Menu is for making the modem do something.  From this menu
  851. you can make the modem dial-out to another system, configure certain
  852. hardware specific things pertaining to your modem ports and otherwise
  853. control how your online sessions are handled in a general sense.
  854.  
  855. ┌───────────────────┐
  856. │ DIALING DIRECTORY │
  857. └───────────────────┘
  858.  
  859. This option displays the current dialing directory on your screen.
  860. From this dialog box, you may dial, edit or otherwise manipulate any
  861. of the dialing directory entries in any way you wish.  There is a
  862. complete section of this document devoted specifically to the dialing
  863. directory.  Read on for details.
  864.  
  865. You may also access this mode by clicking on the "off-line" field of
  866. the status bar.  This field will automatically change to "on-line"
  867. when connected to a host.  Clicking on this field when on-line will
  868. activate the hang-up option.
  869.  
  870. ┌────────────────┐
  871. │ MANUAL DIALING │
  872. └────────────────┘
  873.  
  874. This command will prompt you to enter the telephone number to dial.
  875. You may enter any digits from 0-9.  Hyphens are ignored.  If you need
  876. to obtain a delay before continuing the rest of the phone number,
  877. enter a comma (,) for a 1/2 second pause. After entering the phone
  878. number, the DIALING window will appear showing you the current status
  879. of RIPterm as it dials the modem.
  880.  
  881. ┌───────────────────┐
  882. │ HANG-UP THE MODEM │
  883. └───────────────────┘
  884.  
  885. This option will attempt to disconnect the modem, thus logging you
  886. off of whatever host you are connected to.
  887.  
  888. You may also hang-up the modem by clicking on the "On-line" field of
  889. the Status Bar.
  890.  
  891. If for some reason, RIPterm was unable to successfully disconnect the
  892. modem, the message "Hang-up Failed" will be displayed and your system
  893. beep to indicate a problem has occured.
  894.  
  895. ┌──────────────────┐
  896. │ INITIALIZE MODEM │
  897. └──────────────────┘
  898.  
  899. Choosing this option will reset the modem, and send the modem
  900. initialization string to the modem.  This will effectively reset the
  901. modem to the configured default settings.
  902.  
  903. The commands sent to the modem can be altered by choosing modem
  904. settings from the Setup menu, or by pressing ALT-O.
  905.  
  906. ┌───────────────────┐
  907. │ MODEM AUTO-ANSWER │
  908. └───────────────────┘
  909.  
  910. This command will transmit the modem auto-answer command string to
  911. the modem.  This command instructs the modem to answer the phone
  912. after a certain number of rings (one ring by default).
  913.  
  914. The commands sent to the modem can be altered by choosing modem
  915. settings from the Setup menu, or by pressing ALT-O.
  916.  
  917. ┌─────────────────────────────┐
  918. │ SERIAL PORT INTERRUPT SETUP │
  919. └─────────────────────────────┘
  920.  
  921. THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
  922. FAMILIAR WITH IBM-PC INTERRUPTS AND HARDWARE SETUP!
  923.  
  924. This option allows you to customize the Interrupt (IRQ) settings for
  925. each of your four COM ports.  Normally this isn't necessary.
  926. However, some PC's have special configurations that require the
  927. terminal's setup to be altered if the serial ports are to function
  928. properly.
  929.  
  930. There are five different interrupts that can be selected for each COM
  931. port (2, 3, 4, 5, and 7).  If two serial ports in the computer use
  932. the same interrupt (i.e., a conflict), then problems may arise.
  933.  
  934. ┌───────────────────────────┐
  935. │ SERIAL PORT ADDRESS SETUP │
  936. └───────────────────────────┘
  937.  
  938. THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
  939. FAMILIAR WITH IBM-PC BASE I/O ADDRESSES AND HARDWARE SETUP!
  940.  
  941. This option allows you to customize the base I/O addresses of the
  942. four COM ports that RIPterm can utilize.  Normally, you will not need
  943. to alter these settings.  If you are a PC technician, or you have a
  944. serial port configuration that doesn't comply with the COM1-COM4
  945. standards, you may need to alter your addresses for these ports to
  946. make RIPterm function properly.  The standard addresses for COM1-4
  947. are as follows on an AT compatible computer:
  948.  
  949.  
  950.         Normal IBM-AT                 Micro Channel
  951.          (ISA/EISA)                       (PS/2)
  952.  
  953.     PORT    ADDRESS    IRQ        PORT    ADDRESS    IRQ
  954.     ----------------------        ----------------------
  955.     COM1      3F8       4         COM1      3F8       4
  956.     COM2      2F8       3         COM2      2F8       3
  957.     COM3      3E8       4         COM3      3220      3
  958.     COM4      2E8       3         COM4      3228      3
  959.  
  960.  
  961. NOTE: The first time you install RIPterm, it will auto-sense if you
  962.       are on a Micro Channel machine, and if so, will attempt to
  963.       customize the Addresses and IRQ's for COM3 and COM4 itself.
  964.  
  965.  
  966. ┌────────────────────────────────────────────────────────────────────┐
  967. │                    2.4.4 ■ THE "TRANSFER" MENU                     │
  968. └────────────────────────────────────────────────────────────────────┘
  969.  
  970. This menu contains options for transferring files TO (downloading) or
  971. FROM (uploading) your system.  These commands make use of File
  972. Transfer Protocols (see below).
  973.  
  974. ┌─────────────────┐
  975. │ DOWNLOAD A FILE │
  976. └─────────────────┘
  977.  
  978. This command downloads (receives) a file from the host to your
  979. system.  This is done by what's called a "protocol" transfer.  A
  980. protocol is like a language that humans speak.  There are a number of
  981. languages like French, English, and Italian.  If two people are
  982. speaking in different languages, the net result is that no
  983. communication occurs.  The same goes for protocols.  Both the host
  984. and the terminal (RIPterm) must use the same protocol if they are to
  985. communicate properly.
  986.  
  987. To download a file, instruct the host which file you want to
  988. transfer. Select a protocol from the menu of available protocols.
  989. When the host says "Ready to download..." or "Ready to send...",
  990. choose the download option of RIPterm and select the same protocol
  991. that you chose on the host.  Enter a filename to save to your local
  992. hard disk and the file transfer will commence.  When the transfer is
  993. done, you will be returned to terminal mode and the file will either
  994. exist on your hard disk, or will be incomplete or missing entirely if
  995. an error occurred.
  996.  
  997. The currently supported protocols are:
  998.  
  999.      X-Modem (checksum)
  1000.      X-Modem (CRC)
  1001.      X-Modem-1K
  1002.      X-Modem-1K (G)
  1003.      Y-Modem (Batch)
  1004.      Y-Modem (G)
  1005.      Z-Modem
  1006.      Kermit
  1007.      ASCII (text files only!)
  1008.  
  1009. ┌───────────────┐
  1010. │ UPLOAD A FILE │
  1011. └───────────────┘
  1012.  
  1013. This command uploads (sends) a file to the host from your system.
  1014. This is done by what's called a "protocol" transfer.  A protocol is
  1015. like a language that humans speak.  There are a number of languages
  1016. like French, English, and Italian.  If two people are speaking in
  1017. different languages, the net result is that no communication occurs.
  1018. The same goes for protocols.  Both the host and the terminal
  1019. (RIPterm) must use the same protocol if they are to communicate
  1020. properly.
  1021.  
  1022. To upload a file, instruct the host to upload, and give the host a
  1023. filename.  Select a protocol from the menu of available protocols.
  1024. When the host says "Ready to upload..." or "Ready to receive...",
  1025. choose the upload option of RIPterm and select the corresponding
  1026. protocol that you chose on the host.  Enter a filename to send from
  1027. your local hard disk and the file transfer will begin.  When the
  1028. transfer is done, you will be returned to terminal mode and if there
  1029. were no errors in transmission, the file will exist on the host.
  1030.  
  1031. The currently supported protocols are:
  1032.  
  1033.      X-Modem (checksum)
  1034.      X-Modem (CRC)
  1035.      X-Modem-1K
  1036.      X-Modem-1K (G)
  1037.      Y-Modem (Batch)
  1038.      Y-Modem (G)
  1039.      Z-Modem
  1040.      Kermit
  1041.      ASCII (text files only!)
  1042.  
  1043. ┌───────────────────────┐
  1044. │ ASCII UPLOAD SETTINGS │
  1045. └───────────────────────┘
  1046.  
  1047. This option modifies the default settings for ASCII (text) uploads.
  1048. Some hosts are picky about how fast they can take text data being
  1049. uploaded to them.  With this in mind, you can set a short delay in
  1050. between each line of text sent to the host, and/or you can set a
  1051. delay in between each character sent to the host.  Fine tuning this
  1052. can make ASCII text uploads fast and the most optimized they can be
  1053. for the host you call.
  1054.  
  1055. One last setting determines how "blank lines" are handled.  For
  1056. example, if you upload a text file into an Email message on a BBS and
  1057. the file has blank lines in it, when that blank line is uploaded to
  1058. the system it might (depending on the BBS package) show a command
  1059. prompt instead of accepting the blank line as "raw text".  RIPterm
  1060. allows you to "transform" blank lines into a single space character
  1061. followed by a carriage return.  This in effect, tricks the BBS into
  1062. thinking you typed something in, but at the same time makes it look
  1063. like a real blank line in your message.
  1064.  
  1065.  
  1066. ┌────────────────────────────────────────────────────────────────────┐
  1067. │                      2.4.5 ■ THE "DATA" MENU                       │
  1068. └────────────────────────────────────────────────────────────────────┘
  1069.  
  1070. The Data Menu is for controlling RIPterm text variables and using the
  1071. local RIPterm database (or viewing the contents of it).  RIPterm's
  1072. ability to store data over long periods of time gives it quite a bit
  1073. of flexibility.  The following sections describe the various features
  1074. available in this menu.
  1075.  
  1076. ┌─────────────────┐
  1077. │ CREATE VARIABLE │
  1078. └─────────────────┘
  1079.  
  1080. This option enters a piece of information into the RIPterm database.
  1081. This information will be saved for future use by either yourself or
  1082. by a host.  You may store just about any piece of information in this
  1083. database.  Each piece of information is associated with a "name". Any
  1084. information entered must be from 1-60 characters in length.  The name
  1085. of the information (also called the variable name), is from 3-12
  1086. characters in length.  An example of this might be:
  1087.  
  1088.     Variable        Information Stored in variable
  1089.     --------------  ------------------------------
  1090.     FIRST_NAME      John
  1091.     LAST_NAME       Doe
  1092.     ADDRESS         123 Anywhere Street
  1093.     PHONE_NUMBER    555-1212
  1094.  
  1095. You may choose to save a data variable either to internal memory, or
  1096. to the permanent database.  This database is "indexed" for high speed
  1097. access of information.  In the event that the Index becomes corrupted
  1098. due to a power failure or something of that nature, it will be
  1099. automatically re-indexed for you.
  1100.  
  1101. ┌────────────────┐
  1102. │ SHOW VARIABLES │
  1103. └────────────────┘
  1104.  
  1105. This option displays all text variables that have been stored to the
  1106. local RIPTERM.DB database file.  All variables are listed to the
  1107. current text window, but are not sent to the host.  This allows you
  1108. to see what is currently in your database.
  1109.  
  1110. NOTE: The variables are appended to the scrollback buffer.  You
  1111.       can view them by selecting text scrollback from the
  1112.       Options menu, or pressing ALT-B.
  1113.  
  1114. ┌────────────────────┐
  1115. │ BUILT-IN VARIABLES │
  1116. └────────────────────┘
  1117.  
  1118. This displays the contents of all text variables that are built into
  1119. RIPterm.  Some variables are pre-defined in the sense that RIPterm
  1120. doesn't need you to instruct it with information.  Among the various
  1121. pre-defined variables are things like $DATE$, $TIME$, and other such
  1122. variables that change frequently.  Some variables do not contain
  1123. valid text data due to their nature.  These might include variables
  1124. like $SBARON$, or $SBAROFF$ which display or hide the Status Bar.
  1125. When listing these variables, the contents are listed as blank.
  1126.  
  1127. NOTE: The variables are appended to the scrollback buffer.  You
  1128.       can view them by selecting text scrollback from the
  1129.       Options menu, or pressing ALT-B.
  1130.  
  1131.  
  1132. ┌────────────────────────────────────────────────────────────────────┐
  1133. │                     2.4.6 ■ THE "SETUP" MENU                       │
  1134. └────────────────────────────────────────────────────────────────────┘
  1135.  
  1136. The Setup Menu provides you with a centralized place to alter
  1137. RIPterm's overall configuration.  You may modify the modem's
  1138. conifiguration, many various General Settings and also the way in
  1139. which telephone numbers are dialed.  The following sections describe
  1140. the various options in detail.
  1141.  
  1142. ┌────────────────┐
  1143. │ MODEM SETTINGS │
  1144. └────────────────┘
  1145.  
  1146. This dialog box will allow you to modify your modem configuration.
  1147. You may alter the modem initialization commands, the auto-answer
  1148. string or the modem reset command string.  These options use standard
  1149. Hayes-compatible modem commands.  If you wish to insert a "pause"
  1150. into the command, simply insert a comma (,) or a tilde (~).
  1151.  
  1152. In addition to modem commands, you may set the current COM port, the
  1153. data bits, stop bits, parity setting and baud rate.  Standard
  1154. settings are either 8 data bits, 1 stop bit and NO parity (8N1), or 7
  1155. data bits, 1 stop bit and EVEN parity (7E1).  Additional options
  1156. allow you to specify the number of seconds to wait for a connection
  1157. (redial time), whether to add CR/LF combinations and whether RIPterm
  1158. is connected directly to a modem or not.  You may also specify flow
  1159. control for the serial port as RTS/CTS control (hardware flow
  1160. control, the most reliable).  If you specify RTS/CTS flow control,
  1161. make sure your modem cable can support the specific signals that
  1162. would make this mode work properly.  Most commonly available serial
  1163. cables support this feature now.  If you have an internal modem, then
  1164. this mode should work for you automatically.
  1165.  
  1166. One final option on this dialog box is the "Use Modem" option. If
  1167. selected (the default), then RIPterm assumes it is connected to a
  1168. modem.  If it is disabled, then RIPterm thinks it is connected to
  1169. another computer directly using a modem eliminator cable (also known
  1170. as a "NULL MODEM" cable).
  1171.  
  1172. To alter the serial port IRQ settings, choose the INTERRUPT SETUP
  1173. option from the Modem Menu.  To alter serial port addresses, choose
  1174. the option SERIAL ADDRESSES from the OPTIONS menu.
  1175.  
  1176. These settings are part of the setup, so once you alter them, you
  1177. should choose the SAVE SETUP option to make them permanent.
  1178.  
  1179. ┌──────────────────┐
  1180. │ GENERAL SETTINGS │
  1181. └──────────────────┘
  1182.  
  1183. The General Settings dialog box controls various miscellaneous
  1184. settings for the RIPterm environment.  The various settings in this
  1185. dialog box are:
  1186.  
  1187.       Download Directory .......... Directory where downloaded
  1188.                                     files are stored.
  1189.       Upload Directory ............ Directory where files to be
  1190.                                     uploaded are stored.
  1191.       Scrollback Size (in K) ...... The size of the scrollback
  1192.                                     buffer (from 5-64k)
  1193.       Printer Port configuration .. The LPT port that your
  1194.                                     printer is connected to or
  1195.                                     zero (0) for no printer.
  1196.       Status Bar .................. If checked, then the Status
  1197.                                     Bar is displayed on screen.
  1198.       Zooming Windows ............. If checked, all windows
  1199.                                     will "zoom in/out".
  1200.       Enable Beeps ................ If enabled, any CTRL-G (bel)
  1201.                                     character that is received
  1202.                                     will "beep" your local
  1203.                                     console.
  1204.       VT-102 Emulation ............ When enabled, RIPterm will
  1205.                                     utilize VT-102 extensions of
  1206.                                     ANSI text graphics.
  1207.       Shell to EMS/XMS ............ If checked, when you choose a
  1208.                                     DOS Shell RIPterm will swap
  1209.                                     all but 5.5k of your 640k
  1210.                                     memory to EMS or XMS memory
  1211.                                     giving you all memory for your
  1212.                                     DOS Shell.
  1213.       Mouse Field Select .......... When selected, you may use the
  1214.                                     TAB/SHIFT-TAB key combinations
  1215.                                     to select "mouse fields" on the
  1216.                                     screen.  If disabled, the TAB
  1217.                                     key functions normally (ie,
  1218.                                     transmitted to the BBS).
  1219.       101-key keyboard ............ If enabled, this option will
  1220.                                     provide 101-key support for
  1221.                                     Doorway Mode.
  1222.       Hot-key mode ................ If enabled, then Mouse Button
  1223.                                     Hotkeys for BBS menus will
  1224.                                     react when you hit the proper
  1225.                                     key on the keyboard, thus
  1226.                                     activating the option.
  1227.       Data security ............... This mode prevents any BBS from
  1228.                                     querying info from your terminal
  1229.                                     without you being given the
  1230.                                     opportunity to approve the
  1231.                                     information transfer.
  1232.       Zmodem Recovery ............. When active, Zmodem will attempt
  1233.                                     to recover from an aborted
  1234.                                     transfer if a file by the same
  1235.                                     name exists on the local hard
  1236.                                     disk.  When disabled, Zmodem
  1237.                                     will always overwrite any file.
  1238.       Auto Zmodem Download ........ When selected, you will not have
  1239.                                     to indicate that a download is
  1240.                                     in progress - Zmodem transfers
  1241.                                     will automatically begin the
  1242.                                     moment the BBS begins sending.
  1243.                                     In other words, you don't have
  1244.                                     to hit PGDN to say that a download
  1245.                                     has begun.
  1246.       Force DTR on exit ........... This option allows you to control
  1247.                                     whether the modem signal DTR is
  1248.                                     left ON or OFF after exiting
  1249.                                     RIPterm.  Some modems act
  1250.                                     differently depending on the setting
  1251.                                     of DTR.  Consult your modem guide
  1252.                                     for more details on its DTR support.
  1253.  
  1254. ┌──────────────────┐
  1255. │ DIALING PREFIXES │
  1256. └──────────────────┘
  1257.  
  1258. This option allows you to alter your dialing Prefix and Suffix
  1259. settings.  These settings are used for every system you try to dial
  1260. to begin the dialing operation (prefix), and to finish the dialing
  1261. process (suffix).  You are allowed up to three choices for each, and
  1262. any one of those three entries can be set to be the "Default"
  1263. prefix/suffix.  See the Dialing Prefix/Suffix section below for more
  1264. details.
  1265.  
  1266. ┌────────────┐
  1267. │ SAVE SETUP │
  1268. └────────────┘
  1269.  
  1270. This option will save a number of configuration parameters for
  1271. RIPterm.  Among the various items maintained in the Setup are:
  1272.  
  1273.     ■ All of the "Modem Settings"
  1274.     ■ All of the "General Settings"
  1275.     ■ All of the "Modem Prefix/Suffix" settings
  1276.     ■ All "ASCII Upload Settings"
  1277.     ■ Serial Port IRQ Interrupt settings (for all four ports)
  1278.     ■ Serial Port I/O Address settings (for all four ports)
  1279.     ■ System Font setting
  1280.     ■ Dialing Directory TOGGLE status
  1281.  
  1282. Each time you load RIPterm, the setup is loaded and used for the
  1283. current session.
  1284.  
  1285. Setup information is contained in a file called RIPTERM.CNF by
  1286. default.  This can be altered by using the -S parameter when starting
  1287. up RIPterm.  This option instructs RIPterm to use an alternate setup
  1288. file (e.g., RIPTERM -Smysetup.cnf).
  1289.  
  1290.  
  1291. ┌────────────────────────────────────────────────────────────────────┐
  1292. │                   2.4.7 ■ THE "EXTERNAL" MENU                      │
  1293. └────────────────────────────────────────────────────────────────────┘
  1294.  
  1295. The External Menu is used for manipulating and configuring external
  1296. MS-DOS application programs to be used from within RIPterm.  The
  1297. following sections give a brief overview of what the options in this
  1298. menu do.  For more detailed explanations of external applications,
  1299. see the section of this document devoted to the subject.
  1300.  
  1301. ┌───────────────────┐
  1302. │ EDIT APPLICATIONS │
  1303. └───────────────────┘
  1304.  
  1305. This option allows you to edit up to ten (10) different configurable
  1306. application programs.  The Application feature allows you to
  1307. "plug-in" external programs into RIPterm to do various things.  From
  1308. this menu option, you can edit the configurations of all ten
  1309. "Application slots".  You may custom tailor how the programs are run,
  1310. what slot they are associated with, whether they should be run 'on'
  1311. particular files that you download, and various other settings that
  1312. may pertain to running external programs.
  1313.  
  1314. ┌──────────────────┐
  1315. │ RUN APPLICATIONS │
  1316. └──────────────────┘
  1317.  
  1318. This menu allows you to select an external application to run.  When
  1319. chosen, the "command line" for the program is processed and if any
  1320. text variables (see below) are present it will process them as well
  1321. to construct a complete MS-DOS Command Line.  When all processing on
  1322. the command line is complete, RIPterm will physically "shell-to-DOS"
  1323. and run the specified program.
  1324.  
  1325.  
  1326. ╔════════════════════════════════════════════════════════════════════╗
  1327. ║                        3.0 ■ RIPTERM SETUP                         ║
  1328. ╚════════════════════════════════════════════════════════════════════╝
  1329.  
  1330. In the following sections are the features of RIPterm which control
  1331. the setup and configuration of RIPterm.  Since this is a communications
  1332. program, you may notice that there are a large number of configuration
  1333. options to choose from.  This section is designed to answer the most
  1334. frequently asked questions about what a particular option does so that
  1335. you can make the right choices for your configuration.
  1336.  
  1337.  
  1338. ┌────────────────────────────────────────────────────────────────────┐
  1339. │                   3.1 ■ MODEM SETUP INFORMATION                    │
  1340. └────────────────────────────────────────────────────────────────────┘
  1341.  
  1342. When you choose the Modem Options feature, a dialog box appears to
  1343. edit many of the available modem settings that are a part of
  1344. RIPterm.  The dialog box looks similar to the following:
  1345.  
  1346. ╔════════════════════════════════════════════════════════════════════╗
  1347. ║                            Modem Options                           ║
  1348. ║              ┌───────────────────────────────────────────────────┐ ║
  1349. ║   Modem Init │ AT &C1 &D2 E1 V1 X4^M                             │ ║
  1350. ║              ├───────────────────────────────────────────────────┤ ║
  1351. ║  Auto Answer │ AT S0=1^M                                         │ ║
  1352. ║              ├───────────────────────────────────────────────────┤ ║
  1353. ║  Modem Reset │ AT Z^M                                            │ ║
  1354. ║              ├────┬──────────────────────────────────────────────┘ ║
  1355. ║  Redial Time │ 45 │                               ┌──────────────┐ ║
  1356. ║              └────┘                      Com Port │ 1           │ ║
  1357. ║                                                   ├──────────────┤ ║
  1358. ║    Use Modem  ■    Port Lock  ■         Baud Rate │ 9600        │ ║
  1359. ║    Add CR/LF  ■   Local Echo  ■                   ├──────────────┤ ║
  1360. ║      RTS/CTS  ■   DTR hangup  ■         Data Bits │ 8           │ ║
  1361. ║                                                   ├──────────────┤ ║
  1362. ║                                            Parity │ None        │ ║
  1363. ║┌────────┐┌────────┐┌────────┐┌────────┐           ├──────────────┤ ║
  1364. ║│   OK   ││ CANCEL ││  SAVE  ││  HELP  │ Stop Bits │ 1           │ ║
  1365. ║└────────┘└────────┘└────────┘└────────┘           └──────────────┘ ║
  1366. ╚════════════════════════════════════════════════════════════════════╝
  1367.  
  1368. This dialog box is for modifying your modem configuration.  You may
  1369. alter the modem initialization commands, the auto-answer string and
  1370. the modem reset command string.  These options use standard
  1371. Hayes-compatible modem commands.  If you wish to insert a "pause"
  1372. into the command, simply insert a comma (,).
  1373.  
  1374. In addition to modem commands, you may set the COM port, data bits,
  1375. stop bits, parity, and baud rate.  Standard settings are 8 data bits,
  1376. 1 stop bit and NO parity (8N1), or 7 data bits, 1 stop bit and EVEN
  1377. parity (7E1).  Additional options allow you to specify the number of
  1378. seconds to wait for a connection (redial time), whether to add CR/LF,
  1379. and whether RIPterm is connected directly to a modem or not.
  1380.  
  1381. To alter the serial port IRQ settings, choose the interrupt setup
  1382. option from the modem menu.
  1383.  
  1384. These settings are part of the setup, so once you alter them, you
  1385. should choose the SAVE button at the bottom of the dialog box.
  1386.  
  1387.  
  1388. ┌────────────────────────────────────────────────────────────────────┐
  1389. │                   3.1.1 ■ GENERAL MODEM SETTINGS                   │
  1390. └────────────────────────────────────────────────────────────────────┘
  1391.  
  1392. ┌─────────────┐
  1393. │ REDIAL TIME │
  1394. └─────────────┘
  1395.  
  1396. The "redial time" setting allows you to specify how many seconds
  1397. RIPterm should wait before assuming that the dialed system isn't
  1398. answering.  This value is set by default to 45 seconds.  You might
  1399. need to extend this to a higher value if you're calling through an
  1400. elaborate telephone system.  Shortening the duration may be desirable
  1401. if you are dialing a number where the Host connects quickly and you
  1402. don't need the extended redial times.
  1403.  
  1404. ┌──────┐
  1405. │ PORT │
  1406. └──────┘
  1407.  
  1408. This option allows you to specify which communications port will be
  1409. used to dial the modem.  Valid ports are COM1 through COM4.  Of
  1410. course, your system must have the given port in order to be able to
  1411. dial out on it.  RIPterm will normally initialize the modem upon
  1412. initial bootup providing the "Use Modem" option is selected.
  1413.  
  1414. ┌──────┐
  1415. │ BAUD │
  1416. └──────┘
  1417.  
  1418. This option allows you to specify the default baud rate in which
  1419. RIPterm should operate.  Valid baud rates are 300, 1200, 2400, 4800,
  1420. 9600, 19200, 38400, 57600, and 115200 baud.
  1421.  
  1422. ┌───────────┐
  1423. │ DATA BITS │
  1424. └───────────┘
  1425.  
  1426. This option allows you to alter the number of data bits that will be
  1427. used for a given communications link.  Valid settings are 7 data
  1428. bits, or 8 data bits.  You will find that most hosts use 8 data
  1429. bits.  7 data bits are commonly used when calling mainframe
  1430. computers, or large hosts like TymNet, TeleNet, GEnie, CompuServe, or
  1431. other nationwide network services that use the X.25 network
  1432. protocol.  When in doubt, try 8 data bits.  If you get garbled
  1433. information, try 7.
  1434.  
  1435. ┌────────┐
  1436. │ PARITY │
  1437. └────────┘
  1438.  
  1439. This option allows you to alter the parity setting that will be used
  1440. for a given communications link.  Valid settings are EVEN, ODD or
  1441. NONE.  The vast majority of hosts in the world use a setting of NONE,
  1442. for "No Parity".  Situations where you will choose something other
  1443. than NONE would be if you were calling a mainframe computer, or
  1444. dialing up via a nationwide network like TymNet, TeleNet, GEnie,
  1445. CompuServe, or other such X.25-based hosts. If in doubt, try NONE.
  1446.  
  1447. ┌───────────┐
  1448. │ STOP BITS │
  1449. └───────────┘
  1450.  
  1451. This option allows you to alter the number of "Stop Bits" that are
  1452. used for the communications link.  Valid settings are 1 stop bit, or
  1453. 2 stop bits.  Typically, 1 stop bit will be used for the vast
  1454. majority of hosts.
  1455.  
  1456. In the last three sub-sections, you've seen settings for data bits,
  1457. parity, and stop bits.  In nearly 100% of every situation, there are
  1458. only two combinations of these three values that are used. They are:
  1459.  
  1460.           8 data bits         7 data bits
  1461.            No parity          Even parity
  1462.           1 stop bit          1 stop bit
  1463.           -----------         -----------
  1464.             8-N-1               7-E-1           <- referred to as
  1465.         eight-none-one      seven-even-one      <- pronounced
  1466.  
  1467. ┌───────────┐
  1468. │ USE MODEM │
  1469. └───────────┘
  1470.  
  1471. If selected, RIPterm will assume that it is directly connected to a
  1472. physical modem device.  This is the normal, default situation.  If
  1473. you are using RIPterm to connect directly to another computer via a
  1474. serial link (i.e., a "null modem"), then you would not want to have
  1475. this option set.  If this option is enabled, then RIPterm will send
  1476. the "Modem Init" command string to the modem when RIPterm boots up.
  1477. If this option is not selected then RIPterm will simply tap the
  1478. <ENTER> key for you when it boots up to get some kind of a response
  1479. from the BBS that its directly connected to.
  1480.  
  1481. ┌───────────┐
  1482. │ ADD CR/LF │
  1483. └───────────┘
  1484.  
  1485. This option will add CR/LF combinations at the end of text lines.
  1486. Normally, this is not necessary.  Some hosts however, require that
  1487. CR/LF's be ON for you to see text properly.  Normally, this option is
  1488. OFF.  You may toggle it ON if need be.
  1489.  
  1490. If text coming across the modem does not move to the next line, then
  1491. you need to turn this option ON.  If every line of text is separated
  1492. by a blank line, then you need to toggle this OFF.
  1493.  
  1494. ┌─────────┐
  1495. │ RTS/CTS │
  1496. └─────────┘
  1497.  
  1498. This option determines whether any "flow control" should be used
  1499. between your computer and your modem.  With RIPterm, flow control is
  1500. very important at high baud rates.  It is critically important with
  1501. high speed file transfers with protocols like Zmodem or Ymodem.
  1502. Without flow control, the BBS might be sending data faster than the
  1503. terminal can take it in.  RTS/CTS is a form of "hardware flow
  1504. control".  What this means is that the hardware (i.e., Modem &
  1505. computer) know how to tell each other "I'm ready for more data now,
  1506. continue...".
  1507.  
  1508. In order to take advantage of this mode of operation you need to make
  1509. sure you have a full "hardware handshaking" serial cable.  99% of all
  1510. serial cables you can purchase for an IBM-PC now'a'days are these
  1511. types of cables.  If for some obscure reason, RTS/CTS flow control is
  1512. not usable on your particular PC configuration, RIPterm will issue
  1513. the error message:
  1514.  
  1515.       "CTS is inactive, so RTS/CTS handshaking is disabled"
  1516.  
  1517. What this means is that RIPterm sensed that RTS/CTS was not allowable
  1518. and it will automatically shut off that mode for you so that RIPterm
  1519. will function properly.  NOTE, THIS ERROR MESSAGE CAN ALSO OCCUR IF
  1520. YOU BOOT-UP RIPTERM WHILE YOUR MODEM IS TURNED OFF!
  1521.  
  1522. When viewing RIPscrip graphics at high baud rates (9600 baud and
  1523. higher), this form of flow control is EXTREMELY IMPORTANT!  Without
  1524. it you could easily have garbled graphics.  The reason for this is
  1525. when you're working in a graphical environment, you are doing a lot
  1526. of stuff "behind the scenes" to show even so much as a single line on
  1527. the screen.  Since graphics mode can be so CPU intensive, sometimes
  1528. it is necessary to tell the BBS to "hold on" while the terminal
  1529. "catches up" with the BBS.  That is what flow control is used for and
  1530. why RIPterm really would like to have this mode active.
  1531.  
  1532. ┌───────────┐
  1533. │ PORT LOCK │
  1534. └───────────┘
  1535.  
  1536. Port Lock is used with high speed modems.  Before explaining why you
  1537. need it, let's discuss how a regular modem works with Baud Rates.
  1538. Normally, a modem must be set for the exact same baud rate as the
  1539. connection.  For example, if the modem says:
  1540.  
  1541.                      "CONNECT 2400"
  1542.  
  1543. then RIPterm must be set for 2400 baud if it is to talk to the remote
  1544. Host (BBS).  RIPterm will automatically see this CONNECT 2400 message
  1545. and automatically switch baud rates for you (auto-baud detect).
  1546.  
  1547. Now with High Speed modems the situation is a bit different.  Most
  1548. high speed modems achieve higher baud rates by compressing data,
  1549. transmitting it, and letting the modem on the other end of the
  1550. connection de-compress the data.  Now, image a connection like this:
  1551.  
  1552.              ┌───────┐
  1553.              │       │
  1554.              │       │   9600
  1555.            ┌─┴───────┴─┐ baud ┌─────┐
  1556.            │ Computer  │════│Modem│
  1557.            └───────────┘      └─────┘
  1558.                                  
  1559.                            /9600 ║           ┌───────┐
  1560.                 Telephone / baud ║           │       │
  1561.                 connection\          9600   │       │
  1562.                            \  ┌─────┐ baud ┌─┴───────┴─┐
  1563.                               │Modem│════│ Computer  │
  1564.                               └─────┘      └───────────┘
  1565.  
  1566. Notice that the links between each computer and their respective
  1567. modems are set for 9600 baud.  Also, the telephone connection itself
  1568. is also at 9600 baud.  Now, lets say one computer sends a 10k packet
  1569. of data to its modem.  The modem compresses that data into a smaller
  1570. packet, say 5k for the point of discussion.  Now that data takes half
  1571. as long to transmit.  The modem on the other end of the connection
  1572. decompresses the packet to get the original 10k packet again and it
  1573. shoots it out the serial port to the computer.  Now if another 5k
  1574. compressed packet is coming over the phone line immediately after the
  1575. first one, the modem has to decompress that packet and send it to the
  1576. computer as well.  If the link between the computer and the modem is
  1577. THE SAME SPEED as the telephone link (modem-to-modem) then the act of
  1578. decompressing data packets might create more data than the computer
  1579. can accept at the given baud rate.  It is possible to LOSE data
  1580. because of serial port speeds.
  1581.  
  1582. The solution in situations like this is to set the baud rate of
  1583. RIPterm to a value higher than the highest connection speed.  For
  1584. example, if you have a 14,400 baud modem, you might be inclined to
  1585. set your baud rate in RIPterm to 19,200 baud (the next highest
  1586. setting).  In practice though, modems can compress data better than
  1587. that.  The next highest setting is 38,400 baud which is a very good
  1588. choice.  However, for optimal results, you would want to set RIPterm
  1589. at a rate like 57,600 baud (roughly 4 times the speed of the modem).
  1590. This insures that even if the modem decompressed a packet that was
  1591. compressed down to 25% of its original size, the computer could
  1592. receive the data at full speed from the modem.
  1593.  
  1594. Now, back to PORT LOCK.  Port Lock is used for high speed modems to
  1595. tell RIPterm NOT to perform auto-baud detection when connecting to
  1596. other systems.  What this means is that the baud rate indicated in
  1597. the dialing directory will not change even if the two modems sync-up
  1598. at a lower baud rate.  In this way, the speed between the computer
  1599. and the modem are at a fixed rate always and the baud rate between
  1600. the two modems can vary.
  1601.  
  1602. When Port Lock is enabled, RIPterm will let the modems worry about
  1603. getting their speeds "just right".  Even if your high speed modem
  1604. only connected at 300 baud, RIPterm could still talk to the modem at
  1605. 57,600 baud.  The modem would handle all of the details about "flow
  1606. control" between the computer/modem to make sure that data doesn't
  1607. get stuffed into the modem faster than the telephone connection can
  1608. handle.
  1609.  
  1610. ┌────────────┐
  1611. │ LOCAL ECHO │
  1612. └────────────┘
  1613.  
  1614. This command will toggle whether RIPterm should echo keystrokes to
  1615. the terminal locally, or let the host perform the echoing.  Normally,
  1616. the host will do this for you, so echo is OFF by default.  In some
  1617. situations though, you may wish to toggle ECHO ON.  One such
  1618. situation is if you are directly connected to another person's
  1619. computer via modem and are typing to them in a "chat-like" manner.
  1620.  
  1621. ┌────────────┐
  1622. │ DTR HANGUP │
  1623. └────────────┘
  1624.  
  1625. DTR hangup is often referred to as "quick hangup".  When activated,
  1626. RIPterm will lower the DTR signal on the modem for 1 second to try to
  1627. tell the modem to "hangup".  Many modems will respond to this form of
  1628. hangup command.  In order for the modem to recognize this mode of
  1629. operation, make sure you have the "AT &D2" command in your modem
  1630. initialization command string.  This is the modem command to tell
  1631. your modem to disconnect if DTR is inactive.  If for some obscure
  1632. reason DTR doesn't hangup the modem, RIPterm will attempt to hangup
  1633. the modem by issuing the typical hangup command:
  1634.  
  1635.            +++ATH0^m
  1636.  
  1637. If after trying both methods the modem still hasn't hung-up, RIPterm
  1638. will say "Hangup Failed" and beep your PC Speaker.
  1639.  
  1640. ┌────┐
  1641. │ OK │
  1642. └────┘
  1643.  
  1644. When chosen, OK will take all of the modem options and make them
  1645. current.  It will re-initialize the serial port if necessary and make
  1646. any of the changes active.  The changes are not automatically saved
  1647. to the RIPterm setup file - you must do that yourself.  After
  1648. choosing this item, the dialog box will close and you will be
  1649. returned to the terminal window.
  1650.  
  1651. ┌────────┐
  1652. │ CANCEL │
  1653. └────────┘
  1654.  
  1655. When chosen, any changes in the Modem Options dialog box will be
  1656. discarded.  Whatever settings were active before entering this dialog
  1657. box will be restored.  You will be sent immediately to the terminal
  1658. window.
  1659.  
  1660. ┌──────┐
  1661. │ SAVE │
  1662. └──────┘
  1663.  
  1664. This option will close the dialog box and automatically save the
  1665. current settings to the RIPterm setup file.
  1666.  
  1667. ┌──────┐
  1668. │ HELP │
  1669. └──────┘
  1670.  
  1671. This will display a help screen for the modem options dialog box.
  1672.  
  1673.  
  1674. ┌────────────────────────────────────────────────────────────────────┐
  1675. │                   3.1.2 ■ MODEM COMMAND STRINGS                    │
  1676. └────────────────────────────────────────────────────────────────────┘
  1677.  
  1678. Modem command strings are how you configure RIPterm to work with the
  1679. wide variety of modem on the market.  All modem commands begin with
  1680. an "AT", short for 'ATtention'.
  1681.  
  1682. You may specify control characters in a modem command string by
  1683. preceding the character with a caret (^).  For example, a CTRL-C
  1684. would be ^C and carriage return (CTRL-M) would be ^M.
  1685.  
  1686. Each modem command string should end with a ^M (carriage return), as
  1687. shown in the Modem Options dialog box above.
  1688.  
  1689. You may also use the tilde (~) to insert a 1/2 second pause in your
  1690. modem command strings.
  1691.  
  1692. For more information on modem commands, consult your modem's manual.
  1693.  
  1694. ┌───────────────────┐
  1695. │ MODEM INIT STRING │
  1696. └───────────────────┘
  1697.  
  1698. This field is the modem command that is sent to the modem when
  1699. RIPterm starts up.  All modem commands begin with an "AT", short for
  1700. 'ATtention'.  You may specify control characters in a modem command
  1701. string by preceding the character with a caret (^).  For example, a
  1702. CTRL-C would be ^C.
  1703.  
  1704. ┌──────────────────────────┐
  1705. │ MODEM AUTO-ANSWER STRING │
  1706. └──────────────────────────┘
  1707.  
  1708. This modem command is what would be sent to the modem to set it for
  1709. "auto-answer" mode.  Auto-answer means that the modem will answer the
  1710. phone automatically when it rings.  The default auto-answer string
  1711. which should work on nearly any modem is "AT S0=1^m" where the "1"
  1712. indicates that the modem should pick up the phone after the 1st ring.
  1713.  
  1714. ┌────────────────────┐
  1715. │ MODEM RESET STRING │
  1716. └────────────────────┘
  1717.  
  1718. This is the modem command string that is sent when the modem needs to
  1719. be reset.  This may be necessary if you "hang-up" the modem, abort a
  1720. dial attempt, or exit RIPterm.  For most modems, this command is Z,
  1721. which would be entered as "ATZ^m".
  1722.  
  1723.  
  1724. ┌────────────────────────────────────────────────────────────────────┐
  1725. │                  3.2 ■ GENERAL SETUP INFORMATION                   │
  1726. └────────────────────────────────────────────────────────────────────┘
  1727.  
  1728. RIPterm has a number of configurable settings for you to choose from
  1729. to alter the way in which the software runs on a normal basis.  You
  1730. may opt to modify the Modem Options, or the General Settings which do
  1731. not directly pertain to the modem itself.  The General Settings
  1732. dialog box looks similar to the following:
  1733.  
  1734. ╔════════════════════════════════════════════════════════════════════╗
  1735. ║                          General Settings                          ║
  1736. ║                                                  Scrollback Size(k)║
  1737. ║          Status Bar  ■      101-key keyboard  ■       ┌────┐       ║
  1738. ║     Zooming Windows  ■          Hot-key mode  ■       │ 64 │       ║
  1739. ║        Enable Beeps  ■         Data security  ■       └────┘       ║
  1740. ║    VT-102 Emulation  ■       Zmodem Recovery  ■    Printer Port    ║
  1741. ║    Shell to EMS/XMS  ■  Auto Zmodem Download  ■       ┌────┐       ║
  1742. ║  Mouse Field Select  ■     Force DTR on exit  ■       │ 1  │       ║
  1743. ║        Alarm Sounds  ■                                └────┘       ║
  1744. ║                                                                    ║
  1745. ║               ┌──────────────────────────────────────────────────┐ ║
  1746. ║  Download Dir │ FILES\                                           │ ║
  1747. ║               ├──────────────────────────────────────────────────┤ ║
  1748. ║    Upload Dir │ FILES\                                           │ ║
  1749. ║               └──────────────────────────────────────────────────┘ ║
  1750. ║      ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐        ║
  1751. ║      │    OK    │  │  CANCEL  │  │   SAVE   │  │   HELP   │        ║
  1752. ║      └──────────┘  └──────────┘  └──────────┘  └──────────┘        ║
  1753. ╚════════════════════════════════════════════════════════════════════╝
  1754.  
  1755. ┌────────────┐
  1756. │ STATUS BAR │
  1757. └────────────┘
  1758.  
  1759. If selected, the status bar will be displayed at the bottom of your
  1760. RIPterm screen.  When this option is not checked, the status bar will
  1761. not be displayed and your text window will be one line taller.  The
  1762. status bar is used to access frequently viewed information and to see
  1763. the current status of various aspects of the RIPterm system.
  1764.  
  1765. ┌──────────────┐
  1766. │ ZOOM WINDOWS │
  1767. └──────────────┘
  1768.  
  1769. In RIPterm, whenever a window or dialog box pops up on the screen, it
  1770. will "zoom in" and "zoom out" giving a visual feeling of the window
  1771. opening or closing.  This will slow down operation of the windowing
  1772. system a small amount.  For optimal performance of RIPterm, toggle
  1773. zoom windows off.  However, the visual impression of windows opening
  1774. or closing can be quite useful.
  1775.  
  1776. ┌──────────────┐
  1777. │ ENABLE BEEPS │
  1778. └──────────────┘
  1779.  
  1780. This will enable the Beep character (ASCII character 7, BEL) to make
  1781. an audible sound on your PC speaker when recieved from the host.  If
  1782. this option is not selected, RIPterm will be "quiet" by not making
  1783. hardly any beeps.  Only BEEP characters from the BBS will be enabled
  1784. or disabled.  The musical sounds received when you achieve a
  1785. connection or when a download are complete will not be affected by
  1786. this setting.
  1787.  
  1788. ┌─────────────┐
  1789. │ VT-102 MODE │
  1790. └─────────────┘
  1791.  
  1792. This command enables the VT-102 terminal emulation mode.  This makes
  1793. the following keystrokes send something to the Host:
  1794.  
  1795.                           F1 ...  ESC [ M
  1796.                           F2 ...  ESC [ N
  1797.                           F3 ...  ESC [ O
  1798.                           F4 ...  ESC [ P
  1799.                           F5 ...  ESC [ Q
  1800.                           F6 ...  ESC [ R
  1801.                           F7 ...  ESC [ S
  1802.                           F8 ...  ESC [ T
  1803.                           F9 ...  ESC [ U
  1804.                          F10 ...  ESC [ V
  1805.                         PGUP ...  ESC [ I
  1806.                         PGDN ...  ESC [ G
  1807.                         HOME ...  ESC [ H
  1808.                          END ...  ESC [ F
  1809.                       INSERT ...  ESC [ L
  1810.                    CURSOR UP ...  ESC [ A
  1811.                    CURSOR DN ...  ESC [ B
  1812.                  CURSOR LEFT ...  ESC [ C
  1813.                 CURSOR RIGHT ...  ESC [ D
  1814.  
  1815. In addition, many ANSI escape sequences function slightly differently
  1816. than in normal ANSI mode.  When in this mode, RIPterm tries to act
  1817. like a VT-102 compatible terminal.
  1818.  
  1819. ┌──────────────────┐
  1820. │ SHELL TO EMS/XMS │
  1821. └──────────────────┘
  1822.  
  1823. By default, RIPterm will swap the contents of memory out to a
  1824. temporary disk-file when you choose the DOS Shell option or if you
  1825. run an external application program.  If your IBM-AT has any EMS
  1826. (expanded) or XMS (extended) memory, you can enable this option to
  1827. make your DOS Shell/applications execute faster.  If chosen, this
  1828. option will physically swap the contents of your conventional memory
  1829. to expanded or extended memory instead of to the slower disk-based
  1830. storage.  If you run into any problems trying to get your DOS Shell
  1831. to work properly, try disabling this option.
  1832.  
  1833. ┌────────────────────┐
  1834. │ MOUSE FIELD SELECT │
  1835. └────────────────────┘
  1836.  
  1837. This option, when check marked, will use TAB and SHIFT-TAB to select,
  1838. in order, the mouse fields defined on the screen.
  1839.  
  1840. If this item is not check marked, the TAB character (control-I) is
  1841. transmitted to the host.
  1842.  
  1843. ┌──────────────┐
  1844. │ ALARM SOUNDS │
  1845. └──────────────┘
  1846.  
  1847. When this option is chosen, RIPterm will make various blips, beeps
  1848. and sounds when things happen in RIPterm like successful downloads,
  1849. establishing a connection to a host, beeping when you make a mistake
  1850. and other such things.  If you want RIPterm to be as quiet as
  1851. possible, turn Alarm Sounds off.  If you also set Enable Beeps to
  1852. OFF, RIPterm will make NO sounds what so ever.
  1853.  
  1854. ┌──────────────────┐
  1855. │ 101-KEY KEYBOARD │
  1856. └──────────────────┘
  1857.  
  1858. This mode is used in the "doorway mode".  It allows you to send
  1859. extended 101-key keyboard codes to the doorway system running on the
  1860. host.  This mode is only available on AT computers with a 101-key
  1861. enhanced AT keyboard.  If this option locks up your system, disable
  1862. it.
  1863.  
  1864. This value is part of the RIPterm setup, saved in RIPTERM.CNF.  If
  1865. you set this option ON, and it locks your system, and your system
  1866. locks whenever you start-up RIPterm, then the option has been saved
  1867. to your setup.  You should run RIPterm with the -E option, like this:
  1868.  
  1869.     RIPTERM -E
  1870.  
  1871. The first thing you should do is disable the 101-key keyboard option
  1872. and save your setup with ALT-S.  The -E option overrides Enhanced
  1873. 101-key keyboard support for the duration of the current session of
  1874. RIPterm.
  1875.  
  1876. ┌──────────────┐
  1877. │ HOT KEY MODE │
  1878. └──────────────┘
  1879.  
  1880. This option allows the user to determine whether his keystrokes
  1881. should be checked with the BBS buttons or not for activation. In
  1882. other words, if the BBS places a button on the screen like this:
  1883.  
  1884.                   ┌────────────────┐
  1885.                   │                │
  1886.                   │  (E)nter name  │
  1887.                   │                │
  1888.                   └────────────────┘
  1889.  
  1890. ...where the hotkey for the button is "E", simply pressing the "E"
  1891. key on your keyboard would normally activate this button.  This may
  1892. not be desirable if you're trying to send a message to another user
  1893. with the letter "E" in it.  Now, there's a way around this: Hotkey
  1894. Release Mode.
  1895.  
  1896. Hotkey Release mode is linked to your SCROLL-LOCK key on your
  1897. keyboard.  If Scroll Lock is lit, then hotkeys are processed.  If it
  1898. is not lit, then the character will be sent to the BBS directly,
  1899. bypassing any button hotkeys.
  1900.  
  1901. ┌───────────────┐
  1902. │ DATA SECURITY │
  1903. └───────────────┘
  1904.  
  1905. This option gives you control over host data queries to your system.
  1906. This option defaults to ON, giving you the ability to scrutinize any
  1907. queries by the host to ask your system for a piece of information.
  1908. This does not apply to pre-defined text variables, just variables
  1909. that contain data that you've entered.
  1910.  
  1911. How does this apply to you?  Well, RIPscrip has the inherent ability
  1912. to pop-up dialog boxes onto your screen asking you for a piece of
  1913. information.  Depending on the request, this information might be
  1914. stored to your local RIPterm database for future use (by the same
  1915. host, or potentially another).  This option exists so that if a host
  1916. asks your terminal for a piece of information, you have the ability
  1917. to intervene (i.e., prevent the information from being sent).  This
  1918. override feature is for security purposes in the event that your
  1919. database contains sensitive information that you do not want to be
  1920. given out without your explicit consent.
  1921.  
  1922. ┌─────────────────┐
  1923. │ ZMODEM RECOVERY │
  1924. └─────────────────┘
  1925.  
  1926. This option controls whether Zmodem should attempt to recover from a
  1927. failed transmission.  In the event that a file transfer was aborted
  1928. for whatever reason, Zmodem will normally try to pick up where it
  1929. left off.  If this option is selected, then Zmodem will automatically
  1930. try to resume where it left off.  If this mode is not enabled, then
  1931. Zmodem will physically re-transmit the entire file over again.
  1932.  
  1933. ┌──────────────────────┐
  1934. │ AUTO-ZMODEM DOWNLOAD │
  1935. └──────────────────────┘
  1936.  
  1937. When this option is selected, Zmodem downloads will begin
  1938. automatically the moment the BBS starts the transfer.  If for some
  1939. reason this operation is desirable, this option is provided so that
  1940. you can disable this.  When disabled, you will need to initiate the
  1941. Zmodem download on your own.  A Zmodem download can easily be spotted
  1942. if you see the sequence "**" on your screen.  If RIPterm sees this
  1943. sequence, and the Auto-Zmodem Download option is enabled, it will
  1944. automatically begin the Zmodem transfer without you having to
  1945. intervene - thus making the process simpler.
  1946.  
  1947. ┌───────────────────┐
  1948. │ FORCE DTR ON EXIT │
  1949. └───────────────────┘
  1950.  
  1951. This option defaults to ON.  When On, RIPterm will physically keep
  1952. the DTR signal active after exiting RIPterm.  This is so that if you
  1953. have exited RIPterm while still online (and say not to hangup) then
  1954. it will keep DTR enabled so that the modem doesn't try to disconnect
  1955. you.  This also comes into play on direct serial connections.  Some
  1956. modems however do not like this type of operation, especially if the
  1957. modem is not physically connected to another computer via a telephone
  1958. line after exiting RIPterm.  In cases like this, set this option to
  1959. OFF.  When OFF, RIPterm will physically lower (and keep low) the DTR
  1960. signal when it is finished with a particular Serial Port.  This has
  1961. the net effect of ending any connection that might exist on that port
  1962. and also prevent some modems from answering the phone if an incoming
  1963. call is detected.
  1964.  
  1965. Some modems, even if you instruct them to pick up the phone on the
  1966. first ring, will not answer the phone if DTR is low.  This is so
  1967. because the modem assumes that if DTR is low, that there is no
  1968. terminal program running on the PC to receive the call so why should
  1969. it answer the phone?  Not all modems work this way.
  1970.  
  1971. ┌─────────────────────┐
  1972. │ SET SCROLLBACK SIZE │
  1973. └─────────────────────┘
  1974.  
  1975. This option sets how much memory RIPterm should use for the
  1976. scrollback buffer.  The valid settings are from 5k - 64k of memory.
  1977. Depending on how much conventional memory you have on your computer,
  1978. this may limit the amount of memory you can allocate to scrollback.
  1979. We recommend that you set it to somewhere around 32k unless you know
  1980. that your PC has quite a bit of its 640k memory free for use.  If you
  1981. have numerous memory resident programs (TSR's) loaded, you may need
  1982. to drop the size of your scrollback buffer to a smaller value for
  1983. proper operation of RIPterm.
  1984.  
  1985. If RIPterm runs out of memory, it will begin to discard old
  1986. scrollback buffer information until it can satisfy the memory
  1987. request.
  1988.  
  1989. ┌──────────────┐
  1990. │ PRINTER PORT │
  1991. └──────────────┘
  1992.  
  1993. RIPterm allows you to print information to your local printer if you
  1994. wish.  In order to perform these types of operations, RIPterm needs
  1995. to know which port your printer is connected to.  Valid ports are
  1996. LPT1 through LPT3 (1-3).  If you do not have a printer, or you do not
  1997. wish printer services to be available in RIPterm, you may enter a
  1998. value of "0" to indicate "no printer".  If you set RIPterm to "no
  1999. printer" status, choosing any of the print operations in the software
  2000. will issue a message indicating that you cannot print.
  2001.  
  2002. ┌────────────────────┐
  2003. │ DOWNLOAD DIRECTORY │
  2004. └────────────────────┘
  2005.  
  2006. The download directory setting allows you to determine where files
  2007. that are downloaded from Host BBS'es will be stored on your hard
  2008. disk.  By default, RIPterm will place files that are downloaded into
  2009. the current RIPterm directory (e.g., C:\RIPTERM\).  You can plug in
  2010. your own directory name in this field if you wish to place files into
  2011. another location.  This option is most often used to prevent files in
  2012. your RIPterm runtime directory from being overwritten, or from
  2013. cluttering up your RIPterm directory with a lot of files.
  2014.  
  2015. ┌──────────────────┐
  2016. │ UPLOAD DIRECTORY │
  2017. └──────────────────┘
  2018.  
  2019. The upload directory setting allows you to instruct RIPterm where
  2020. files that you will SEND to a BBS are located.  By default, files are
  2021. assumed to be in the local RIPterm directory unless this field
  2022. contains an MS-DOS Drive/path value.  Any settings must correspond to
  2023. an existing DOS directory.  You are not 100% restricted to uploading
  2024. files from this directory only.  If you wish to upload a file from
  2025. some other directory, you do not have to alter this setting if you
  2026. don't want to.  When prompted to enter a filename to upload, simply
  2027. type the path to the file directly.  RIPterm is smart enough to
  2028. recognize that you gave it an "explicit path" to the file and will
  2029. temporarily overide the default upload directory setting for that one
  2030. file only.
  2031.  
  2032. ┌────┐
  2033. │ OK │
  2034. └────┘
  2035.  
  2036. When chosen, OK will take all of the general settings and make them
  2037. current.  The changes are not automatically saved to the RIPterm
  2038. setup file - you must do that yourself.  After choosing this item,
  2039. the dialog box will close and you will be returned to the terminal
  2040. window.
  2041.  
  2042. ┌────────┐
  2043. │ CANCEL │
  2044. └────────┘
  2045.  
  2046. When chosen, any changes in the general settings dialog box will be
  2047. discarded.  Whatever settings were active before entering this dialog
  2048. box will be restored.  You will be sent immediately to the terminal
  2049. window.
  2050.  
  2051. ┌──────┐
  2052. │ SAVE │
  2053. └──────┘
  2054.  
  2055. This option will close the dialog box and automatically save the
  2056. current settings to the RIPterm setup file.
  2057.  
  2058. ┌──────┐
  2059. │ HELP │
  2060. └──────┘
  2061.  
  2062. This will display a help file for the general settings dialog box.
  2063.  
  2064.  
  2065. ┌────────────────────────────────────────────────────────────────────┐
  2066. │                3.3 ■ DIALING PREFIXES AND SUFFIXES                 │
  2067. └────────────────────────────────────────────────────────────────────┘
  2068.  
  2069. Dialing prefixes affect the way your modem dials telephone numbers.
  2070. Prefixes and Suffixes are used to allow you to dial some numbers a
  2071. certain way and other numbers in a totally different manner.
  2072.  
  2073. In order for your modem to dial a phone number, it must be issued a
  2074. particular command.  Under most circumstances this command is the
  2075. same for every number you dial in your dialing directory.  This can
  2076. change though if you have different types of systems you call.  For
  2077. example, on some BBS'es you might have to disable error correction on
  2078. your modem to connect.  You wouldn't want to put the modem AT
  2079. commands into your telephone number to accomplish this because it
  2080. just won't work.  To better illustrate how Prefixes and Suffixes are
  2081. related to dialing, consult the following:
  2082.  
  2083.       <Prefix>    <Phone Number>    <Suffix>
  2084.         ATDT        555-1212           ^M
  2085.  
  2086. The normal Prefix is "ATDT".  This stands for (AT)tention (D)ial
  2087. (T)ouch-tone.  If you were dialing out on a rotary phone line, that
  2088. would be (P)ulse dialing (i.e., "ATDP").  This would be a typical use
  2089. for a dialing prefix.  Also, if you had say several modems connected
  2090. to your machine and you dialed out on different ones for different
  2091. services, you could have one prefix setup that dialed a "9" to get an
  2092. outside number, and a different setting for a "direct outside line".
  2093. Prefixes would be "ATDT 9," and "ATDT" respectively.
  2094.  
  2095. Another use for Dialing Prefixes are for phone number passwords.  If
  2096. you work for a company that requires you to enter a password in order
  2097. to dial-out, you could accomplish this as follows, "ATDT 1234567~".
  2098. The 1234567 is your password and the tilde (~) is used for a 1/2
  2099. second pause.  After the pause the remainder of the phone number in
  2100. the dialing directory will be dialed followed by the Dialing Suffix.
  2101.  
  2102. The Modem Prefix/Suffix Editor dialog box looks similar to the
  2103. following:
  2104.  
  2105. ╔════════════════════════════════════════════════════════════════════╗
  2106. ║                     Modem Prefix/Suffix Editor                     ║
  2107. ║   ┌──────────────────────────────────────┐ ┌────────────────────┐  ║
  2108. ║   │            Modem Prefixes            │ │   Modem Suffixes   │  ║
  2109. ║   │      ┌─────────────────────────────┐ │ │      ┌───────────┐ │  ║
  2110. ║   │ 1  X │ ATDT                        │ │ │ A  X │ ^M        │ │  ║
  2111. ║   │      ├─────────────────────────────┤ │ │      ├───────────┤ │  ║
  2112. ║   │ 2  ■ │ ATDP                        │ │ │ B  ■ │ ^M        │ │  ║
  2113. ║   │      ├─────────────────────────────┤ │ │      ├───────────┤ │  ║
  2114. ║   │ 3  ■ │ ATDT 9,                     │ │ │ C  ■ │ ^M        │ │  ║
  2115. ║   │      └─────────────────────────────┘ │ │      └───────────┘ │  ║
  2116. ║   └──────────────────────────────────────┘ └────────────────────┘  ║
  2117. ║         ┌──────────┐      ┌──────────┐      ┌──────────┐           ║
  2118. ║         │    OK    │      │  CANCEL  │      │   HELP   │           ║
  2119. ║         └──────────┘      └──────────┘      └──────────┘           ║
  2120. ╚════════════════════════════════════════════════════════════════════╝
  2121.  
  2122. Notice that in the Modem Prefix section of the dialog box that there
  2123. are three different settings labeled 1, 2 and 3.  Just to the right
  2124. of each of these labels is a set of check-boxes.  Only one of them
  2125. can be selected at any one time.  Whichever one is selected is
  2126. actually the "default" Prefix in RIPterm.  You may set your dialing
  2127. directory entries to use the "default prefix".  Then if you need to
  2128. change all your directory entries to use a different dialing method
  2129. quickly, simply change which prefix is the default and you're done.
  2130.  
  2131. Similar to the Prefix section of the dialog box, the Suffix section
  2132. also has the ability to set a "default suffix".  The method is the
  2133. exact same as that for prefixes except that each suffix is labeled A,
  2134. B and C respectively.
  2135.  
  2136. If you choose a Prefix setting of "Default", then whichever of the
  2137. three Prefix definitions you have tagged as "Default" will be used.
  2138. You may also explicity set a Prefix of 1, 2 or 3 to select a
  2139. particular Prefix.  The idea behind the Default option is evident if
  2140. you have your entire directory set to "default", then you take your
  2141. computer somewhere where you need to dial say, "9" to get an outside
  2142. line and you need to change your entire configuration quickly.
  2143.  
  2144. A Dialing Suffix is the last thing that is transmitted to the modem
  2145. when dialing a phone number.  The first thing transmitted is the
  2146. dialing Prefix, followed by the phone number, then the suffix.
  2147. Typically, the suffix is only a carriage return (^M).  However, you
  2148. could get fancy with it and put other things before the carriage
  2149. return like a phone number password (if it has to be entered "after"
  2150. the phone number".  This would be useful if you wanted to apply this
  2151. to all dialing directory entries simultaneously.
  2152.  
  2153.  
  2154. ╔════════════════════════════════════════════════════════════════════╗
  2155. ║                    4.0 ■ THE DIALING DIRECTORY                     ║
  2156. ╚════════════════════════════════════════════════════════════════════╝
  2157.  
  2158. When you choose the "Dialing Directory" option, a dialog box similar
  2159. to the following will appear:
  2160.  
  2161. ╔═══════════════════════════════════════════════════════════════════╗
  2162. ║                   Dialing Directory: RIPTERM.PHO                  ║
  2163. ╟───────────────────────────────────────────────────────────────────╢
  2164. ║ ┌─────────────────────────────────────────────────────────────┬─┐ ║
  2165. ║ │  1.  ArenaBBS            1-714-379-2133     2400  8N1  COM1 ││ ║
  2166. ║ │  2.  RIP Demo Midwest    1-708-978-2777    19200  8N1  COM2 ├─┤ ║
  2167. ║ │  3.  Nova Central        1-714-379-9004     9600  8N1  COM1 ││ ║
  2168. ║ │  4.  Galacticomm BBS     1-305-583-7808     9600  8N1  COM1 ││ ║
  2169. ║ │  5.  deltaComm BBS       1-919-481-9399    19200  8N1  COM1 ├─┤ ║
  2170. ║ │  6.  Searchlight BBS     1-516-689-2566    19200  8N1  COM1 ├─┤ ║
  2171. ║ │  7.  Synchronet BBS      1-714-529-9547    19200  8N1  COM1 ││ ║
  2172. ║ │  8.  Wildcat BBS         1-805-395-0650     9600  8N1  COM1 ││ ║
  2173. ║ │  9.  PC Board BBS        1-801-261-8976    19200  8N1  COM1 ├─┤ ║
  2174. ║ │ 10.  E-Soft (TBBS)       1-303-699-8222     9600  8N1  COM1 ││ ║
  2175. ║ └─────────────────────────────────────────────────────────────┴─┘ ║
  2176. ║      ┌────────┬────────┬────────┬────────┬────────┬────────┐      ║
  2177. ║      │  Edit  │  Mark  │ Unmark │ SaveAs │  Load  │  Find  │      ║
  2178. ║      ├────────┼────────┼────────┼────────┼────────┼────────┤      ║
  2179. ║      │  Dial  │ Cancel │  Kill  │  Print │ Toggle │  Help  │      ║
  2180. ║      └────────┴────────┴────────┴────────┴────────┴────────┘      ║
  2181. ╚═══════════════════════════════════════════════════════════════════╝
  2182.  
  2183. At the top of the dialing directory dialog box, the filename of the
  2184. dialing directory is displayed (e.g., "RIPTERM.PHO").  Whenever you
  2185. change dialing directory files, this will change to reflect the
  2186. current file in use.
  2187.  
  2188. In the middle of the dialog box is a listing of available hosts to
  2189. choose from.  Ten hosts are displayed at any one time, and each
  2190. directory can contain up to 100 entries.  You can scroll through the
  2191. available hosts quickly by using the UP/DOWN arrows on the right of
  2192. the display.  Just underneath the UP arrow, and above the DOWN arrow
  2193. are two different buttons; these are used for PGUP, and PGDN.  The UP
  2194. ARROW, DOWN ARROW, PGUP, PGDN, HOME, and END keys work intuitively.
  2195.  
  2196. Any one of the ten lines in the window can be highlighted by pressing
  2197. ALT-1 through ALT-0 (10).  Any previously highlighted entries will be
  2198. un-highlighted and the given line in the window will be highlighted.
  2199. If you simultaneously hold down the SHIFT key while pressing ALT-1
  2200. through ALT-0, then the associated line will be highlighted in
  2201. addition to any previously highlighted lines (highlight merge).  Do
  2202. not confuse ALT-1 through ALT-0 with the numbers listed on the left
  2203. side of the window.  The numbers in the window are the entries in the
  2204. entire directory, not the window line number.  Pressing an ALT-1
  2205. through ALT-0 will highlight the window line number.  To highlight a
  2206. specific directory entry, see the MARK mode below.
  2207.  
  2208. Each host displays an entry number, the host name, telephone number,
  2209. baud rate, data bits (7 or 8), parity (E, N, O), stop bits (1 or 2),
  2210. and the COM port (COM1 - COM4).
  2211.  
  2212. There are twelve buttons at the bottom of the dialog box to choose
  2213. from.  They function as follows:
  2214.  
  2215. ┌──────┐
  2216. │ EDIT │
  2217. └──────┘
  2218.  
  2219. Clicking this button edits one or more dialing directory entries.  At
  2220. least one entry must be highlighted (marked).  When clicked, a dialog
  2221. box will appear for each host highlighted allowing you to edit each
  2222. host's characteristics.  See the next section for details on the
  2223. Dialing Directory Editor.
  2224.  
  2225. ┌──────┐
  2226. │ DIAL │
  2227. └──────┘
  2228.  
  2229. Selecting DIAL calls one or more selected directory entries.  If more
  2230. than one entry is highlighted, they will be dialed in numerical
  2231. order.  If a connection is established to any host, it will be
  2232. un-highlighted in the dialing directory so that later re-entry into
  2233. the directory will allow you to dial the remaining hosts.  This
  2234. option is automatically highlighted as the "default option" if at
  2235. least one directory entries is highlighted.
  2236.  
  2237. ┌──────┐
  2238. │ MARK │
  2239. └──────┘
  2240.  
  2241. This option will mark (highlight) one or more dialing directory
  2242. entries for subsequent action.  When chosen, a dialog box will appear
  2243. allowing you to enter information.  In this dialog box, you can enter
  2244. one or more numbers indicating which directory entry(s) to
  2245. highlight.  There are a number of options you may choose from for
  2246. highlighting entries.  Some examples are:
  2247.  
  2248.     Examples:
  2249.     ---------
  2250.         1            ... highlight entry 1
  2251.         1, 2, 3      ... highlight entries 1, 2 and 3
  2252.         1 2 3        ... highlight entries 1, 2 and 3
  2253.         1;2;3        ... highlight entries 1, 2 and 3
  2254.         1-10         ... highlight entries 1 through 10
  2255.         15-          ... highlight entries 15 to the end (100)
  2256.         -5           ... highlight from Start (1) to entry 5
  2257.         -            ... highlight ALL entries
  2258.         1-5, 10, 95- ... highlight 1-5, 10 and 95-100
  2259.  
  2260. In addition, you can also specify a "Mark Merge".  This mode allows
  2261. you to combine your Marked entries with any entries that are already
  2262. marked.  To use Mark Merge mode, enter a plus sign (+) as the first
  2263. character.  For example, if entries 3 and 5 are highlighted, and you
  2264. mark "+ 10-15", then entries 3, 5, and 10-15 will be highlighted.
  2265.  
  2266. One final option is the Mark Exclude mode.  This mode is similar to
  2267. Mark Merge, except that all entries EXCEPT those highlighted are
  2268. marked.  In other words, anything that you would think would be
  2269. highlighted, would not be, and anything that shouldn't be
  2270. highlighted, will be!  This odd way of doing things can become very
  2271. handy when combined with some of the other options in the dialing
  2272. directory.  To choose Mark Exclude mode, specify an exclamation mark
  2273. (!) as the first character.
  2274.  
  2275. You can combine Mark Merge, and Mark Exclude modes together.  To do
  2276. this, enter the sequence "+!" as the first two characters in the
  2277. dialog box.
  2278.  
  2279. Mark Mode will be automatically chosen if you begin typing something
  2280. that appears to be a mark sequence.  In other words, you do not have
  2281. to select Mark mode in order to Mark entries. For example, from the
  2282. dialing directory dialog box, simply typing "1" will bring up the
  2283. Mark dialog and place "1" in the editing field automatically and
  2284. allow you to continue typing in your Mark expression.
  2285.  
  2286. ┌────────┐
  2287. │ CANCEL │
  2288. └────────┘
  2289.  
  2290. This will abort the dialing directory window.  Any previously
  2291. highlighted entries will remain highlighted the next time you enter
  2292. the directory.  You are returned to the terminal screen.
  2293.  
  2294. ┌────────┐
  2295. │ UNMARK │
  2296. └────────┘
  2297.  
  2298. This will un-highlight any previously highlighted directory entries.
  2299. You may also press the Space Bar to choose this option.
  2300.  
  2301. ┌──────┐
  2302. │ KILL │
  2303. └──────┘
  2304.  
  2305. This option will delete all previously highlighted directory
  2306. entries.  You will be prompted to make absolutely sure that you truly
  2307. wish to erase the entries.  All calling statistics for those entries
  2308. will be erased as well.  Once an option is killed, it is permanently
  2309. deleted.  If no entries are highlighted, this option has no affect.
  2310.  
  2311. ┌─────────┐
  2312. │ SAVE AS │
  2313. └─────────┘
  2314.  
  2315. This option will save either the entire dialing directory, or just
  2316. the highlighted entries to another directory file.  This allows you
  2317. to create new directory files quickly and easily for specific
  2318. purposes. If one or more entries are highlighted, only those entries
  2319. are copied to the new file.  If no entries are highlighted, then the
  2320. entire dialing directory file is copied.  You will be prompted to
  2321. enter the destination filename.
  2322.  
  2323. If the destination file exists, it is checked to see if it is a
  2324. RIPterm dialing directory file.  If it is, you will be prompted to
  2325. either merge the highlighted entries into destination file, or to
  2326. overwrite the file with just the highlighted entries.
  2327.  
  2328. In the event that the destination file becomes full, a message to the
  2329. effect will be displayed informing you how many entries couldn't be
  2330. copied.
  2331.  
  2332. This "directory merge" feature is unique to RIPterm.
  2333.  
  2334. NOTE: Modifications to the dialing directory are automatically
  2335.       saved to the current directory file.  You do not need to
  2336.       choose SAVE AS every time you add or edit an entry.
  2337.  
  2338. ┌───────┐
  2339. │ PRINT │
  2340. └───────┘
  2341.  
  2342. This prints the contents of the dialing directory (or highlighted
  2343. entries) to either a disk file, or to a printer attached to the
  2344. configured printer port.  Choosing the disk option will prompt you
  2345. for a filename.
  2346.  
  2347. Before printing/saving occurs, you will be asked what type of output
  2348. you wish.  You have two choices: TABLE format, or DETAILED
  2349. BREAKDOWN.  Table format will print one entry per line, formatted for
  2350. an 80-column display.
  2351.  
  2352. System Name          System Phone Number
  2353. ===========================================  continued next line
  2354. ArenaBBS (TeleGrafix 1-714-379-2133
  2355.  
  2356.                             Baud COM COM       Last  Mod
  2357.                             Rate Vals # Calls  Call   ? Direc.
  2358. continued from previous     ====================================
  2359.                             2400  8N1 1   39  1/30/93 Y ARENA
  2360.  
  2361. Specifying detailed mode will output a multi-line record for each
  2362. entry. The format of detailed breakdown mode is similar to the
  2363. following:
  2364.  
  2365.       Host Name: ArenaBBS (TeleGrafix)
  2366.     Telephone #: 1-714-379-2133
  2367.       Baud Rate: 2400
  2368.       Data Bits: 8
  2369.          Parity: NONE
  2370.       Stop Bits: 1
  2371.        COM Port: 1
  2372.       Directory: ARENA
  2373.     Connections: 39
  2374.       Last Call: 01/30/93
  2375.  
  2376. ┌──────┐
  2377. │ LOAD │
  2378. └──────┘
  2379.  
  2380. This option allows you to load up another dialing directory file.
  2381. The current directory file will be closed and the specified file will
  2382. be loaded in its place.  All entries are un-highlighted, and the
  2383. window will automatically display the newly loaded entries.
  2384.  
  2385. ┌────────┐
  2386. │ TOGGLE │
  2387. └────────┘
  2388.  
  2389. This option alters what information is displayed in the dialing
  2390. directory window.  By default, the following information is displayed
  2391. on each line in the window:
  2392.  
  2393.     Entry #
  2394.     Host Name
  2395.     Phone Number
  2396.     Baud Rate
  2397.     Data Bits, Parity and Stop Bits (e.g., 8N1)
  2398.     Communications Port (e.g., COM1)
  2399.  
  2400. When you choose the toggle option, the information displayed will be
  2401. changed to the following:
  2402.  
  2403.     Entry #
  2404.     Host Name
  2405.     Total # of calls
  2406.     Last call date
  2407.     Directory ID (see below)
  2408.     Modem or Serial-Port connection
  2409.  
  2410. This is a simple toggle.  Each time you choose this option, the
  2411. information displayed will change to the opposite mode.
  2412.  
  2413. Your favorite toggle setting can be saved to your permanent RIPterm
  2414. setup.  To do this, choose the toggle mode you like the best, exit
  2415. the dialing directory, then choose Save Setup.
  2416.  
  2417. ┌──────┐
  2418. │ FIND │
  2419. └──────┘
  2420.  
  2421. This option will highlight one or more entries that contain the
  2422. specified search text.  Once you choose this option, a dialog box
  2423. will appear prompting you to enter a piece of text to search for
  2424. throughout the dialing directory.  Any entries that contain the
  2425. chosen text will be automatically highlighted.  Search is not case
  2426. sensitive.  The host name, phone number and directory-ID fields are
  2427. searched for the text.  Text can appear anywhere in any of these
  2428. three fields and will still be found.
  2429.  
  2430. You may choose Find Merge mode, or Find Exclude mode (or both)
  2431. exactly the same way as you can with the Mark mode.  The command
  2432. characters (+ and !) are not added to the search string, and must be
  2433. the first characters specified in the search string.  Merge mode can
  2434. be quite useful if you wish to highlight all entries in a specific
  2435. area code, or that contain a common theme (like "business", or
  2436. "daily").
  2437.  
  2438. ┌──────┐
  2439. │ HELP │
  2440. └──────┘
  2441.  
  2442. This option displays the help screen for the dialing directory.
  2443.  
  2444.  
  2445. ┌────────────────────────────────────────────────────────────────────┐
  2446. │              4.1 ■ EDITING DIALING DIRECTORY ENTRIES               │
  2447. └────────────────────────────────────────────────────────────────────┘
  2448.  
  2449. When you choose to edit one or more dialing directory entries, a
  2450. dialog box similar to the following will appear on your screen
  2451. allowing you to edit the various entries:
  2452.  
  2453. ╔════════════════════════════════════════════════════════════════════╗
  2454. ║                         Phone Entry Editor                         ║
  2455. ╟────────────────────────────────────────────────────────────────────╢
  2456. ║        ┌─────────────────────────┐                ┌──────────────┐ ║
  2457. ║   Name │Host name goes here...   │       Com Port │ 1           │ ║
  2458. ║        ├─────────────────────────┤                ├──────────────┤ ║
  2459. ║ Number │1-714-555-1212           │      Baud Rate │ 9600        │ ║
  2460. ║        ├────────────┬────────────┘  ┌─┐           ├──────────────┤ ║
  2461. ║    DIR │Directory   │         Modem │X│ Data Bits │ 8           │ ║
  2462. ║        └────────────┘  ┌───────────┐└─┘           ├──────────────┤ ║
  2463. ║ ┌──────┬──────┐ Prefix │ Default  │       Parity │ None        │ ║
  2464. ║ │ QUIT │ HELP │        ├───────────┤              ├──────────────┤ ║
  2465. ║ ├──────┴──────┤ Suffix │ 1        │    Stop Bits │ 1           │ ║
  2466. ║ │     OK!     │        └───────────┘              └──────────────┘ ║
  2467. ║ └─────────────┘                                                    ║
  2468. ╚════════════════════════════════════════════════════════════════════╝
  2469.  
  2470. The significance of each of these fields are described below:
  2471.  
  2472. ┌──────┐
  2473. │ NAME │
  2474. └──────┘
  2475.  
  2476. The name field is the name of the host that will appear in the
  2477. dialing directory window.  This is the name that will be displayed to
  2478. you whenever you dial the host, and is used in general to describe
  2479. the host.  You are allowed 25 characters for the host name.
  2480.  
  2481. ┌────────┐
  2482. │ NUMBER │
  2483. └────────┘
  2484.  
  2485. This is the telephone number (if any) that is used to dial the host.
  2486. You are allowed up to 25 characters for the number.  Valid characters
  2487. are digits 0-9, hyphens and parenthesis (if your modem permits it).
  2488. You may also enter a comma (,) to indicate a half-second pause.  This
  2489. pause is handled by your modem, not by RIPterm.  On some modems, this
  2490. pause may be two or three seconds.  Check your modem's documentation
  2491. to determine the delay value.  If you wish for RIPterm to perform a
  2492. half-second pause instead of the modem, insert a tilde (~) instead of
  2493. a comma (,).
  2494.  
  2495. Some examples of Telephone Numbers are as follows:
  2496.  
  2497.            555-1212 ... Dial 555-1212
  2498.      1-714-555-1212 ... Dial (714) 555-1212
  2499.          9,555-1212 ... Dial a 9, then pause, then 555-1212
  2500.  
  2501. ┌─────┐
  2502. │ DIR │
  2503. └─────┘
  2504.  
  2505. This field takes a bit more explaining than the other fields in the
  2506. directory editor.  Each entry in the directory has the ability to
  2507. have a separate sub-directory associated with it.  This is used
  2508. mainly when RIPscrip graphics are being viewed on the host. Any icon
  2509. (.ICN, .MSK, .HIC) or RIPscrip (.RIP) files that are received by the
  2510. host should be placed in the designated sub-directory.  This in
  2511. effect, helps keep your icons separated from each other.
  2512.  
  2513. If you omit a directory name in this field, and you dial into a
  2514. RIPscrip host that requires icons or RIPscrip files, RIPterm will
  2515. look for them automatically in the ICONS\ sub-directory.  It is
  2516. recommended that you keep host specific files in their proper
  2517. sub-directories for elegant file maintenance.
  2518.  
  2519. You do not need to create the sub-directory yourself.  The first time
  2520. that you specify a directory in the DIR field, it will be created
  2521. when you click on the OK button.
  2522.  
  2523. If the DIR field is non-blank, indicating a sub-directory should be
  2524. used for that specific host, RIPterm will check in that directory
  2525. first for any necessary icons or RIPscrip files.  If the needed files
  2526. are not found in that sub-directory, RIPterm will check the ICONS\
  2527. sub-directory afterward to see if it is there.  This facilitates the
  2528. concept of "file overide".
  2529.  
  2530. This "file override" is best explained by an example.  Let's say you
  2531. call several different RIPscrip hosts.  Each of them have numerous
  2532. icons that they use for their host.  Now as you are probably aware,
  2533. each sysop of each host thinks of his host as the only host in the
  2534. world.  With that in mind, they would probably not give a great
  2535. amount of thought to the names that they give their icon or RIPscrip
  2536. files (i.e., not considering that other hosts might have files with
  2537. the same names).  Files like EMAIL.ICN or FILES.ICN would be used on
  2538. nearly any host!  If all these files were located in the same
  2539. directory, only the very latest installed files would be used when
  2540. you call a host!  In other words, when you call host XYZ, you might
  2541. see host ABC's EMAIL icon! This is obviously not how it should work.
  2542. With this in mind, keeping files in separate sub-directories resolves
  2543. this problem quite nicely.  Even if a sysop chooses to use the
  2544. standard RIPterm EMAIL icon, he can do that too. All he has to do is
  2545. NOT provide you with his own EMAIL icon.  RIPterm will find the
  2546. correct file for you automatically.  It would first check host XYZ's
  2547. directory (presumably directory "XYZ\"), and after finding that the
  2548. file is not there, would check the ICONS\ sub-directory and find it
  2549. there.  In this fashion, the sysop has the ability to overide
  2550. standard icons with his own without affecting the standard icons in
  2551. any way.
  2552.  
  2553. Keep in mind, that if you dial a host by issuing modem commands
  2554. directly (not using the dialing directory), then the correct
  2555. directory may not be used since RIPterm has no way of knowing which
  2556. dialing directory entry you are calling.  In other words, you should
  2557. use the dialing directory to call ALL RIPscrip hosts!
  2558.  
  2559. NOTE: RIPterm supports a "block protocol" mode for hosts that
  2560.       can support it.  This mode allows the host to send files to
  2561.       your computer for subsequent use.  Any files received in
  2562.       this mode are automatically placed in the proper host DIR
  2563.       directory. If no host DIR field is specified, then the
  2564.       ICONS\ sub-directory is chosen as the destination
  2565.       sub-directory.  The download directory as set in the General
  2566.       Settings dialog box is not used in this situation as the
  2567.       destination directory.
  2568.  
  2569. ┌───────┐
  2570. │ MODEM │
  2571. └───────┘
  2572.  
  2573. This button is a toggle-type button.  It can be either ON or OFF.  If
  2574. it is enabled (the default), then when this entry is dialed, it will
  2575. be assumed that it is calling the host via a modem device.  If it is
  2576. off, then RIPterm will assume that the host is connected to your
  2577. computer via a direct serial connection.
  2578.  
  2579. If the modem option is activated, RIPterm will monitor the modem for
  2580. a "CONNECT" message of some kind.  Other messages that can affect the
  2581. dialing process are "ERROR", "NO DIALTONE", "VOICE" or "BUSY".
  2582.  
  2583. If this option is inactive, typically, connection is made instantly,
  2584. and you will be presented with some kind of an intro message. RIPterm
  2585. will automatically press <ENTER> to the host to try to activate the
  2586. connection for you.
  2587.  
  2588. ┌──────┐
  2589. │ PORT │
  2590. └──────┘
  2591.  
  2592. This option allows you to specify which communications port will be
  2593. used to dial the given host.  Valid ports are COM1 through COM4.  Of
  2594. course, your system must have the given port in order to be able to
  2595. dial out on it.  Before the host is called, RIPterm will initialize
  2596. the given port (if it hasn't already) and if everything is OK, will
  2597. dial the host (or press <ENTER> if it's a non-modem host).
  2598.  
  2599. ┌──────┐
  2600. │ BAUD │
  2601. └──────┘
  2602.  
  2603. This option allows you to specify the baud rate at which the
  2604. connection should be made (or at least attempted).  Valid baud rates
  2605. are 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, and 115200
  2606. baud.  If a CONNECT message is received indicating a baud rate other
  2607. than the specified rate, RIPterm will automatically adjust the baud
  2608. rate on its end to ensure that communication will take place (this is
  2609. often called "auto-baud detect" mode).  This auto-baud detection is
  2610. only performed if PORT LOCK in the Modem Options dialog box is NOT
  2611. set.
  2612.  
  2613. ┌───────────┐
  2614. │ DATA BITS │
  2615. └───────────┘
  2616.  
  2617. This option allows you to alter the number of data bits that will be
  2618. used for a given communications link.  Valid settings are 7 data
  2619. bits, or 8 data bits.  You will find that most hosts use 8 data
  2620. bits.  7 data bits are commonly used when calling mainframe
  2621. computers, or large hosts like TymNet, TeleNet, GEnie, CompuServe, or
  2622. other nationwide network services that use the X.25 network
  2623. protocol.  When in doubt, try 8 data bits.  If you get garbled
  2624. information, try 7.
  2625.  
  2626. In the last three sub-sections, you've seen settings for data bits,
  2627. parity, and stop bits.  In nearly 100% of every situation, there are
  2628. only two combinations of these three values that are used. They are:
  2629.  
  2630.           8 data bits         7 data bits
  2631.            No parity          Even parity
  2632.           1 stop bit          1 stop bit
  2633.           -----------         -----------
  2634.             8-N-1               7-E-1           <- referred to as
  2635.         eight-none-one      seven-even-one      <- pronounced
  2636.  
  2637. ┌────────┐
  2638. │ PARITY │
  2639. └────────┘
  2640.  
  2641. This option allows you to alter the parity setting that will be used
  2642. for a given communications link.  Valid settings are EVEN, ODD or
  2643. NONE.  The vast majority of hosts in the world use a setting of NONE,
  2644. for "No Parity".  Situations where you will choose something other
  2645. than NONE would be if you were calling a mainframe computer, or
  2646. dialing up via a nationwide network like TymNet, TeleNet, GEnie,
  2647. CompuServe, or other such X.25-based hosts. If in doubt, try NONE.
  2648.  
  2649. ┌───────────┐
  2650. │ STOP BITS │
  2651. └───────────┘
  2652.  
  2653. This option allows you to alter the number of "Stop Bits" that are
  2654. used for the communications link.  Valid settings are 1 stop bit, or
  2655. 2 stop bits.  Typically, 1 stop bit will be used for the vast
  2656. majority of hosts.
  2657.  
  2658. ┌────────┐
  2659. │ PREFIX │
  2660. └────────┘
  2661.  
  2662. This option lets you choose from one of several different ways to
  2663. place a call with your modem.  In order for your modem to dial a
  2664. phone number, it must be issued a particular command.  Under most
  2665. circumstances this command is the same for every number you dial in
  2666. your dialing directory.  This can change though if you have different
  2667. types of systems you call.  For example, on some BBS'es you might
  2668. have to disable error correction on your modem to connect.  You
  2669. wouldn't want to put the modem AT commands into your telephone number
  2670. to accomplish this because it just won't work.  To better illustrate
  2671. how Prefixes and Suffixes are related to dialing, consult the
  2672. following:
  2673.  
  2674.       <Prefix>    <Phone Number>    <Suffix>
  2675.         ATDT        555-1212           ^M
  2676.  
  2677. The normal Prefix is "ATDT".  This standards for (AT)tention (D)ial
  2678. (T)ouch-tone.  If you were dialing out on a rotary phone line, that
  2679. would be (P)ulse dialing (i.e., "ATDP").  This would be a typical use
  2680. for a dialing prefix.  Also, if you had say several modems connected
  2681. to your machine and you dialed out on different ones for different
  2682. services, you could have one prefix setup that dialed a "9" to get an
  2683. outside number, and a different setting for a "direct outside line".
  2684. Prefixes would be "ATDT 9," and "ATDT" respectively.
  2685.  
  2686. Another use for Dialing Prefixes are for phone number passwords.  If
  2687. you work for a company that requires you to enter a password in order
  2688. to dial-out, you could accomplish this as follows, "ATDT 1234567~".
  2689. The 1234567 is your password and the tilde (~) is used for a 1/2
  2690. second pause.  After the pause the remainder of the phone number in
  2691. the dialing directory will be dialed followed by the Dialing Suffix.
  2692.  
  2693. If you choose a Prefix setting of "Default", then whichever of the
  2694. three Prefix definitions you have tagged as "Default" will be used.
  2695. You may also explicity set a Prefix of 1, 2 or 3 to select a
  2696. particular Prefix.  The idea behind the Default option is evident if
  2697. you have your entire directory set to "default", then you take your
  2698. computer somewhere where you need to dial say, "9" to get an outside
  2699. line and you need to change your entire configuration quickly.
  2700.  
  2701. ┌────────┐
  2702. │ SUFFIX │
  2703. └────────┘
  2704.  
  2705. A Dialing Suffix is the last thing that is transmitted to the modem
  2706. when dialing a phone number.  The first thing transmitted is the
  2707. dialing Prefix, followed by the phone number, then the suffix.
  2708. Typically, the suffix is only a carriage return (^M).  However, you
  2709. could get fancy with it and put other things before the carriage
  2710. return like a phone number password (if it has to be entered "after"
  2711. the phone number".  This would be useful if you wanted to apply this
  2712. to all dialing directory entries simultaneously.
  2713.  
  2714. ┌────┐
  2715. │ OK │
  2716. └────┘
  2717.  
  2718. This will accept any changes you have made and return you to the
  2719. dialing directory dialog box.  Any changes you made in the editor
  2720. will be reflected in the dialing directory window.  If you have
  2721. highlighted multiple entries to edit, then the remaining entries (if
  2722. any) that haven't been edited will be edited before you are returned
  2723. to the dialing directory screen.
  2724.  
  2725. ┌──────┐
  2726. │ QUIT │
  2727. └──────┘
  2728.  
  2729. This will cancel any modifications you have made in the directory
  2730. editor.  You will be returned to the dialing directory automatically.
  2731. If you have chosen to edit multiple directory entries (by
  2732. highlighting more than one), and there are entries that haven't been
  2733. edited yet, they will be edited before you are eventually returned to
  2734. the dialing directory.
  2735.  
  2736. ┌──────┐
  2737. │ HELP │
  2738. └──────┘
  2739.  
  2740. This option bring up the help screen for the directory editor.
  2741.  
  2742.  
  2743. ┌────────────────────────────────────────────────────────────────────┐
  2744. │     4.2 ■ DIALING DIRECTORY CONVERSION UTILITY (DIALCONV.EXE)      │
  2745. └────────────────────────────────────────────────────────────────────┘
  2746.  
  2747. For your convenience, a utility program has been included with
  2748. RIPterm to convert dialing directory files from other popular
  2749. terminal programs to RIPterm format.  This program currently supports
  2750. the conversion of Telix and TeleMate directory files to RIPterm
  2751. format.  Conversion is "one way".  In other words, you cannot convert
  2752. a RIPterm directory file to Telix format, but you can go the other
  2753. way around (Telix to RIPterm conversion).
  2754.  
  2755. Use of DIALCONV is quite simple.  The program will auto-detect what
  2756. type of dialing directory file is to be processed and will
  2757. automatically use the appropriate conversion method necessary for the
  2758. given file.
  2759.  
  2760. To convert a directory file, enter a command similar to:
  2761.  
  2762.     DIALCONV TELIX.FON RIPTERM.PHO
  2763.  
  2764. In the preceding example, DIALCONV would convert the Telix directory
  2765. file TELIX.FON to a RIPterm directory file called RIPTERM.PHO.
  2766. RIPterm uses the extension of .PHO to designate dialing directories.
  2767.  
  2768. All "statistical" data in the source directory file are converted
  2769. into the new RIPterm file.  For example, the last date a host was
  2770. called, and total number of calls you have made to that host are
  2771. converted as well and are made part of the RIPterm directory file. In
  2772. addition, COM port, baud rate and other settings are converted as
  2773. well for your convenience.
  2774.  
  2775. If you wish to simply view the contents of a Telix or TeleMate
  2776. directory file without conversion (to make sure that conversion would
  2777. take place properly), you can choose an optional "view" option for
  2778. DIALCONV by specifying the "-v" switch on the command line.  For
  2779. example, to list out all the valid entries in a Telix directory file
  2780. called TELIX.FON to the screen, enter the following command:
  2781.  
  2782.     DIALCONV -v TELIX.FON
  2783.  
  2784. All entries will be displayed to the screen for you.  Output can be
  2785. captured to a text file if you wish by using the MS-DOS redirection
  2786. feature.  Using the preceding example, let's say you wanted to print
  2787. all entries in the Telix directory file to the text file TELIX.LST,
  2788. enter the following command:
  2789.  
  2790.     DIALCONV -v TELIX.FON >TELIX.LST
  2791.  
  2792. Note the use of the redirection symbol ">" followed by the filename
  2793. to redirect output to.  You could just have easily directed the
  2794. programs output to the Printer with the following command:
  2795.  
  2796.     DIALCONV -v TELIX.FON >PRN
  2797.  
  2798.  
  2799. ┌────────────────────────────────────────────────────────────────────┐
  2800. │                4.3 ■ DIALING DIRECTORY FILE FORMAT                 │
  2801. └────────────────────────────────────────────────────────────────────┘
  2802.  
  2803. For the technically minded, this section of the document defines the
  2804. internal structure of the RIPterm dialing directory file.  This is
  2805. provided for programmers who wish to create directory maintenance
  2806. utilities.
  2807.  
  2808. A RIPterm dialing directory file is a "flat-file" database with no
  2809. index.  Each record is of fixed length and is stored in numerical
  2810. order from 1-100.  Each entry is exactly 100 bytes in length, so a
  2811. dialing directory file is exactly 10,000 bytes in length.  Blank
  2812. entries are identified by the NAME, PHONE and HOST_ID fields being
  2813. entirely blank (i.e., NULL's).
  2814.  
  2815. The C data structure for each record is as follows:
  2816. ---------------------------------------------------
  2817.  
  2818.   struct phone_entry {
  2819.        char name[25];           /* Name of System             */
  2820.        char phone[25];          /* Phone Number of System     */
  2821.                                 /* -------------------------- */
  2822.        int  com_port;           /* COMx to use (0=default)    */
  2823.        long baud;               /* Baud Rate to dial at       */
  2824.        char data_bits;          /* Data Bits (7-8)            */
  2825.        char stop_bits;          /* Stop Bits (1-2)            */
  2826.        char parity;             /* Parity Setting             */
  2827.                                 /* -------------------------- */
  2828.        char system_id[13];      /* System-ID (resource filenm)*/
  2829.        long total_connects;     /* Total # of connections     */
  2830.        int  last_date;          /* Last Date connected        */
  2831.        int  reserved;           /* Reserved field             */
  2832.        char connected_to;       /* 0=modem, 1=computer        */
  2833.        char prefix;             /* Dialing Prefix (0=def, 1-3)*/
  2834.        char suffix;             /* Dialing Suffix (0=def, 1-3)*/
  2835.        char spare[17];          /* Spare space for upgrades   */
  2836.   };                            /* TOTAL SIZE: 100 bytes      */
  2837.  
  2838. The LAST_DATE field is an integer.  This variable uses the MS-DOS
  2839. method of encoding Dates into a 16-bit number.  Consult the MS-DOS
  2840. Programmer's Reference Manual for details on the internal format of
  2841. DOS Dates.
  2842.  
  2843.  
  2844. ╔════════════════════════════════════════════════════════════════════╗
  2845. ║                     5.0 ■ EXTERNAL APPLICATIONS                    ║
  2846. ╚════════════════════════════════════════════════════════════════════╝
  2847.  
  2848. RIPterm has a powerful feature which allows it to link-in external
  2849. MS-DOS programs into RIPterm to do things quickly and easily from
  2850. within the software.  You are allowed up to ten different
  2851. applications to be programmed into RIPterm.  At the touch of a key
  2852. you can fire off one of your application programs to do things like
  2853. run Microsoft Windows (tm), run text editors, offline mail readers or
  2854. view graphics files like GIF files.
  2855.  
  2856. What makes RIPterm's application system even more powerful is that
  2857. you can link application programs to particular file extensions.  The
  2858. significance of this may not be readily apparent until you think
  2859. about what happens when you download files off of a BBS with the same
  2860. extension as that of another application program.  For example, let's
  2861. say that application #5 is defined as being your local GIF file
  2862. viewer program.  If you link that application to files with a .GIF
  2863. extension, then whenever you download a GIF file you viewer will be
  2864. run immediately instructing it to view the file you just downloaded!
  2865.  
  2866. To make situations even nicer, RIPterm will physically return to
  2867. MS-DOS (text mode) and swap as much of RIPterm's data out of your
  2868. 640k conventional memory as possible before running your application.
  2869. When running applications, RIPterm frees up almost all of your 640k
  2870. memory except for 5.5k that must remain to reload RIPterm when your
  2871. application is complete.  When RIPterm is swapped out of memory it
  2872. will by default store all the program code and data to a temporary
  2873. disk file, unless you have the "Swap to EMS/XMS" option selected in
  2874. the General Settings dialog box.  If you do have EMS/XMS swapping
  2875. enabled, then RIPterm will place all of the necessary data into
  2876. Expanded and/or extended memory (if there's enough available).
  2877. Swapping to EMS/XMS is considerably faster than swapping to disk
  2878. naturally so it is the most desirable method for running your
  2879. applications.
  2880.  
  2881.  
  2882. ┌────────────────────────────────────────────────────────────────────┐
  2883. │                   5.1 ■ THE APPLICATION EDITOR                     │
  2884. └────────────────────────────────────────────────────────────────────┘
  2885.  
  2886. In order to take advantage of external applications, you need to edit
  2887. an application program entry from the EXTERNAL pull-down menu.
  2888. Choose the "Edit Applications" option - you will be presented with a
  2889. list of ten different applications or application "slots".  To insert
  2890. a new application, choose a blank slot.  You will be placed in the
  2891. Application Editor.  The application editor appears similar to the
  2892. following:
  2893.  
  2894. ╔════════════════════════════════════════════════════════════════════╗
  2895. ║                       Application #0 Editor                        ║
  2896. ╟────────────────────────────────────────────────────────────────────╢
  2897. ║                                                    Never  ■        ║
  2898. ║   Description                      Extension         Ask  X        ║
  2899. ║  ┌──────────────────────────────┐  ┌───────┐      Always  ■        ║
  2900. ║  │ Edit a text file             │  │ .TXT  │                       ║
  2901. ║  └──────────────────────────────┘  └───────┘       PAUSE  ■        ║
  2902. ║   Command Line                                                     ║
  2903. ║  ┌──────────────────────────────────────────────────────────────┐  ║
  2904. ║  │ EDIT.COM $FILENAME$                                          │  ║
  2905. ║  └──────────────────────────────────────────────────────────────┘  ║
  2906. ║         ┌──────────┐      ┌──────────┐      ┌──────────┐           ║
  2907. ║         │    OK    │      │  CANCEL  │      │   HELP   │           ║
  2908. ║         └──────────┘      └──────────┘      └──────────┘           ║
  2909. ╚════════════════════════════════════════════════════════════════════╝
  2910.  
  2911. At the top of the dialog box it says which application slot you are
  2912. currently editing.  Slots are identified as slots #0 through slot #9.
  2913. By convention, we recommend that slot #0 be used for an external text
  2914. editor.  In this way, even if a BBS instructs your terminal to edit a
  2915. text file by running application #0, your RIPterm system should be
  2916. able to handle it.  For more information on how a BBS can run
  2917. application programs on your local terminal, see the following
  2918. sections.
  2919.  
  2920. To make your external applications accessible from within RIPterm,
  2921. you need to define them.  That's what the Application Editor is all
  2922. about.  Each of the fields in the Application Editor dialog box is
  2923. explained below:
  2924.  
  2925. ┌─────────────┐
  2926. │ DESCRIPTION │
  2927. └─────────────┘
  2928.  
  2929. The description data field allows you to enter a description for the
  2930. application that will appear in the external application listing.
  2931. This is intended to give you the user of RIPterm a visual idea of
  2932. what the application does.
  2933.  
  2934. ┌──────────────┐
  2935. │ COMMAND LINE │
  2936. └──────────────┘
  2937.  
  2938. This is where the real meat and potatoes of the application editor
  2939. lies.  This is how you define what program to run and how to run it.
  2940. Simply insert the name of the application program (or a batch file)
  2941. in this data field along with any parameters you wish to utilize.
  2942. You may only execute .EXE, .COM or .BAT files and they must be either
  2943. in the current directory, or accessible in your MS-DOS PATH=
  2944. statement.  Consult your DOS manual for more details about the PATH
  2945. setting.
  2946.  
  2947. In addition to being able to specify which program to run, you can
  2948. also utilize one of RIPterm's most advanced features to customize
  2949. your application to suit your needs.  For example, if you were going
  2950. to edit a text file, you need to tell your editor what file you wish
  2951. to edit.  In the screen displayed above showing the Application
  2952. Editor, you will notice the Command Line of "EDIT.COM $FILENAME$".
  2953. Notice the $FILENAME$ portion of the command line.  When you try to
  2954. run this particular application, the phrase $FILENAME$ will be
  2955. replaced with a filename of your choice.  Actually, that is a
  2956. simplistic way of looking at it.  $FILENAME$ is really a RIPterm text
  2957. variable (see section 7.4.2 for more details on Text Variables).
  2958. Text variables are like Macros - they get replaced with another piece
  2959. of information or text.  Depending on the variable, it might be
  2960. replaced with some piece of information that RIPterm knows already
  2961. (like the date for example), or it might insert a piece of text that
  2962. you physically type in.  In the case of $FILENAME$, RIPterm will
  2963. pop-up a dialog box on your screen allowing you to enter the filename
  2964. to edit.
  2965.  
  2966. The $FILENAME$ text variable is sometimes called a "magic text
  2967. variable".  It has special meaning in the External Application system
  2968. of RIPterm.  When you physically choose a particular application to
  2969. run, it will prompt you to enter a filename.  If on the other hand,
  2970. you link an application to a downloaded file, this text variable is
  2971. automatically "filled in" with the name of the file you just
  2972. downloaded, thus preventing you from having to type in the filename
  2973. at all.
  2974.  
  2975. You are not only limited to just simple text variables.  You can also
  2976. use "Pick-List" definitions (again, see the section on text variables
  2977. and Keystroke macros for more details).  This allows you to pop-up a
  2978. listing of available choices.  You might conceivably use this to
  2979. specify different command-line switches to modify the behavior of a
  2980. particular program - something that may be different each time you
  2981. run the program.
  2982.  
  2983. You do not need to place a ^M at the end of your command line.  A
  2984. carriage return will be added automatically when the program is run.
  2985.  
  2986. NOTE:  Leaving the command line blank will result in a simple DOS
  2987.        Shell being executed when you run the application.
  2988.  
  2989. ┌───────────┐
  2990. │ EXTENSION │
  2991. └───────────┘
  2992.  
  2993. As stated previously, you have the ability to link particular
  2994. application programs to files with certain extensions.  For example,
  2995. if you wanted to link a GIF image viewer to files with .GIF
  2996. extensions, simply enter "GIF" in this field.  Then whenever you
  2997. download a file with a .GIF extension, the given application will run
  2998. and the $FILENAME$ text variable will be replaced with the filename
  2999. of the file you just downloaded!  Neat, huh?
  3000.  
  3001. There are three ways that applications can link to downloaded files.
  3002. They can be run NEVER, ALWAYS or it can prompt you if you really want
  3003. to run the application on the particular file you downloaded (ASK).
  3004.  
  3005. ┌────────────────┐
  3006. │ OPTION - NEVER │
  3007. └────────────────┘
  3008.  
  3009. When this option is chosen, the Extension field of the application
  3010. will be ignored.  In other words, the application you are editing
  3011. will never be automatically executed for particular files that you
  3012. download.  Use this option to completely disable auto-download
  3013. application execution for a given application slot.
  3014.  
  3015. ┌──────────────┐
  3016. │ OPTION - ASK │
  3017. └──────────────┘
  3018.  
  3019. When this option is selected and the Extension field contains a DOS
  3020. Extension, RIPterm will check every file that you download to see if
  3021. it has the same extension and if so, it will pop-up a window on your
  3022. screen asking if you wish to run the given application on the file
  3023. you just downloaded.  This is the most "secure" way of using
  3024. application mode.  This gives you complete control over what gets run
  3025. when and where.
  3026.  
  3027. ┌─────────────────┐
  3028. │ OPTION - ALWAYS │
  3029. └─────────────────┘
  3030.  
  3031. This option, when combined with the Extension field, will
  3032. automatically run the given application every time a corresponding
  3033. file with the same extension is downloaded.  You will not be prompted
  3034. if you want to run the application on the file, it will be done for
  3035. you immediately when the download is complete.  The only way that you
  3036. can interact with the act of running the application is if you have
  3037. inserted pick-list definitions or text variable definitions into the
  3038. command line field ($FILENAME$ doesn't count).
  3039.  
  3040. ┌────────────────┐
  3041. │ OPTION - PAUSE │
  3042. └────────────────┘
  3043.  
  3044. When this option is chosen, RIPterm will physically pause before
  3045. returning to RIPterm after your application has completed execution.
  3046. Use this option when you want to have a "Hit any key to return to
  3047. RIPterm" message appear after your application is complete.  For
  3048. example, you might use this option if you have instructed RIPterm to
  3049. run PKZIP to view the contents of each ZIP file you download.
  3050. Naturally, you would like the information to stay on your screen
  3051. after the listing is complete so that you can examine the contents of
  3052. the file.  If you did not select this option, then as soon as the ZIP
  3053. file's contents were displayed on the screen, RIPterm would resume
  3054. and the listing would vanish immediately giving you no opportunity to
  3055. look at the listing.
  3056.  
  3057. ┌────┐
  3058. │ OK │
  3059. └────┘
  3060.  
  3061. Choosing this option approves any modifications you might have made
  3062. in the application editor and saves that application for future use
  3063. in RIPterm.
  3064.  
  3065. ┌────────┐
  3066. │ CANCEL │
  3067. └────────┘
  3068.  
  3069. This option abandons all modifications in the Application Editor,
  3070. restoring the application slot to the state it was in previous to
  3071. entering the Application Editor.
  3072.  
  3073. ┌──────┐
  3074. │ HELP │
  3075. └──────┘
  3076.  
  3077. This option displays a help screen to assist you in editing
  3078. applications.
  3079.  
  3080.  
  3081. ┌────────────────────────────────────────────────────────────────────┐
  3082. │                 5.2 ■ APPLICATION TEXT VARIABLES                   │
  3083. └────────────────────────────────────────────────────────────────────┘
  3084.  
  3085. You can run applications directly from your keystroke macros if you
  3086. wish.  This makes your application programs accessible at the touch
  3087. of a key.  This means that you don't have to pull down the EXTERNAL
  3088. menu and select "Run Application" every time you wish to run your
  3089. favorite programs.  Similar in concept to the $FILENAME$ text
  3090. variable described above, you can also insert application text
  3091. variables directly into your keyboard macros in RIPterm.  When
  3092. executed the macro will automatically run the designated application.
  3093.  
  3094. Application Text Variables are $APP0$ through $APP9$.  Each one
  3095. corresponds to a particular application slot.  If a slot is blank,
  3096. RIPterm will simply execute a DOS Shell.  Unlike the $FILENAME$ text
  3097. variable though, $APP0$ through $APP9$ do not get replaced with any
  3098. piece of text.  For example, if you had the following macro set up:
  3099.  
  3100.  
  3101.           F5:  HELLO $APP0$ WORLD
  3102.  
  3103. Then whenever you hit the F5 key in RIPterm, your macro would send
  3104. the sequence "HELLO " to the BBS, then run application #0 (presumably
  3105. your text editor), then after that is complete, transmit " WORLD" to
  3106. the BBS as the final part of your macro.  Note that we did not use
  3107. the $FILENAME$ variable inside the macro itself - that is specified
  3108. in the command line portion of the application editor.
  3109.  
  3110.  
  3111. ╔════════════════════════════════════════════════════════════════════╗
  3112. ║                      6.0 ■ DIALING THE MODEM                       ║
  3113. ╚════════════════════════════════════════════════════════════════════╝
  3114.  
  3115. Press <ALT-M> to bring up the phone number dialog box.
  3116.  
  3117. Enter the telephone number you wish to dial.  You may enter any
  3118. numeric digits (0-9).  Hyphens are ignored.  Enter a comma for a 1/2
  3119. second delay (e.g., 9,1-714-555-1212).  You may need to add delays if
  3120. you have to use a special service or a switchboard to obtain an
  3121. outside line dial-tone.
  3122.  
  3123. The dialing window will appear when RIPterm is attempting to dial the
  3124. modem.  On this window will be displayed the number of seconds that
  3125. have elapsed, the time that dialing started, the time of the last
  3126. re-dial attempt, the telephone number and other information about the
  3127. dialing state.
  3128.  
  3129. Pressing <ENTER> will abort the current dialing attempt and start
  3130. over.  Pressing <ESC> or clicking "Cancel" will abort dialing.
  3131.  
  3132.  
  3133. ┌────────────────────────────────────────────────────────────────────┐
  3134. │                     6.1 ■ THE DIALING WINDOW                       │
  3135. └────────────────────────────────────────────────────────────────────┘
  3136.  
  3137. When RIPterm dials a host, it will display a dialog box showing you
  3138. the progress when dialing the host.  The dialog box looks similar to:
  3139.  
  3140. ╔═══════════════════════════════════════════════════════════════════╗
  3141. ║          ┌─────────────────────────────────┐                      ║
  3142. ║     Host │ Host name goes here...          │                      ║
  3143. ║          ├─────────────────────────────────┤           ┌─────┐    ║
  3144. ║  Phone # │ 1-714-555-1212                  │   Attempt │ 005 │    ║
  3145. ║          ├──────────┬───────────┬──────────┤           ├─────┼─┐  ║
  3146. ║  Started │ 08:23:25 │   Current │ 08:31:42 │    Remain │ 10  ││  ║
  3147. ║          ├──────────┴───────────┴──────────┴───────────┴─────┴─┤  ║
  3148. ║  Message │ Host is Busy.  Redialing...                         │  ║
  3149. ║          └─────────────────────────────────────────────────────┘  ║
  3150. ║      ╔════════════╗      ┌────────────┐      ┌────────────┐       ║
  3151. ║      ║   REDIAL   ║      │   CANCEL   │      │   DELETE   │       ║
  3152. ║      ╚════════════╝      └────────────┘      └────────────┘       ║
  3153. ╚═══════════════════════════════════════════════════════════════════╝
  3154.  
  3155. Each field is described more fully in the following sections:
  3156.  
  3157. ┌──────┐
  3158. │ HOST │
  3159. └──────┘
  3160.  
  3161. This field displays the name of the host that is being dialed.  This
  3162. field may be blank if you choose to dial via the manual dialing
  3163. method (ALT-M).  If you are dialing by choosing entries from the
  3164. dialing directory, whatever host name is displayed will be shown in
  3165. this field when that entry is dialed.
  3166.  
  3167. ┌─────────┐
  3168. │ PHONE # │
  3169. └─────────┘
  3170.  
  3171. This displays the telephone number that is being used when dialing
  3172. the designated host.  It is shown in this field exactly as it is
  3173. transmitted to the modem.
  3174.  
  3175. ┌─────────┐
  3176. │ STARTED │
  3177. └─────────┘
  3178.  
  3179. This field shows the time that this dialing attempt began. The format
  3180. of this field is HH:MM:SS.  Whenever a number is dialed, or the
  3181. dialing window cycles to the next number, this field is updated with
  3182. the current time that the telephone number is issued to the modem to
  3183. dial out.
  3184.  
  3185. ┌─────────┐
  3186. │ CURRENT │
  3187. └─────────┘
  3188.  
  3189. This field displays the current time.  This field will constantly
  3190. change as the dialing progresses.  It is intended to give you a
  3191. visual reference to the time, compared to the start time.
  3192.  
  3193. ┌─────────┐
  3194. │ MESSAGE │
  3195. └─────────┘
  3196.  
  3197. Periodically through the dialing process, various status messages may
  3198. need to be displayed to give you more information on what is going
  3199. on.  Of the various messages, you might see things like, "Host is
  3200. Busy.  Redialing...", or "Time elapsed without connection". This is
  3201. generally used to tell you what is going on.
  3202.  
  3203. ┌─────────┐
  3204. │ ATTEMPT │
  3205. └─────────┘
  3206.  
  3207. This shows how many attempts have been tried thus far for this phone
  3208. number.  If the host is busy, then it will try again after a brief
  3209. pause.  If you have many hosts "queued" up to dial, then this shows
  3210. the attempt number only for the given host being dialed at the
  3211. moment.  Up to 999 attempts will be made before RIPterm stops all
  3212. dialing attempts to a particular host.
  3213.  
  3214. ┌────────┐
  3215. │ REMAIN │
  3216. └────────┘
  3217.  
  3218. This message displays how many seconds remain before the current
  3219. dialing attempt will terminate.  By default, redial time is set to 45
  3220. seconds, but this can be changed from within the modem options dialog
  3221. box.  High speed modems, or long distance calls frequently need more
  3222. than 45 seconds to complete an outgoing call. To the right of this
  3223. field are two small arrows, an UP arrow, and a DOWN arrow.  These are
  3224. for temporarily increasing or decreasing the redial time for the rest
  3225. of this dialing attempt.
  3226.  
  3227. ┌────────┐
  3228. │ REDIAL │
  3229. └────────┘
  3230.  
  3231. This button will cause what's commonly known as a "cycle" to occur.
  3232. This is used when you have highlighted a number of entries to dial.
  3233. By clicking on redial, it will stop calling whichever host is
  3234. currently being dialed, and will cycle to the next highlighted host
  3235. in your dialing list and begin to dial that number.  If you are only
  3236. dialing one host, this will stop the current dialing attempt and
  3237. re-dial the same number again.
  3238.  
  3239. ┌────────┐
  3240. │ CANCEL │
  3241. └────────┘
  3242.  
  3243. This option will stop dialing.  You will be returned to the RIPterm
  3244. session screen.  Any entries in the dialing directory that you were
  3245. trying to dial will remain highlighted the next time you enter the
  3246. dialing directory.
  3247.  
  3248. ┌────────┐
  3249. │ DELETE │
  3250. └────────┘
  3251.  
  3252. This option will remove an entry from your dial list.  What this
  3253. means is that whatever host is currently being dialed will have its
  3254. dialing attempt stopped, and then it will be un-highlighted in the
  3255. dialing directory, then RIPterm will attempt to dial the next
  3256. highlighted number (if any).  If no more entries are available in the
  3257. dialing list, RIPterm will abort all dialing and return to the
  3258. RIPterm session window.
  3259.  
  3260.  
  3261. ╔════════════════════════════════════════════════════════════════════╗
  3262. ║                   7.0 ■ OTHER RIPTERM FEATURES                     ║
  3263. ╚════════════════════════════════════════════════════════════════════╝
  3264.  
  3265. RIPterm has a great many other features to make your online access
  3266. quicker and easier than ever before.  Some features are advanced and
  3267. some are simple.  In the following sections you will read up on the
  3268. various other features of RIPterm to help make your adventure in the
  3269. online world as simple as possible.
  3270.  
  3271. ┌────────────────────────────────────────────────────────────────────┐
  3272. │                      7.1 ■ SCROLLBACK MODE                         │
  3273. └────────────────────────────────────────────────────────────────────┘
  3274.  
  3275. Scrollback mode allows you to review previously displayed text
  3276. information that has come across the modem.  You may set the
  3277. scrollback buffer size to 5k - 64k.
  3278.  
  3279. Within scrollback, you may choose from the following options:
  3280.  
  3281.     ■ SAVE buffer page to a text file
  3282.     ■ SAVE entire buffer to a text file
  3283.     ■ PRINT the current buffer page, or the entire buffer
  3284.     ■ SEARCH for a particular piece of text
  3285.     ■ SEARCH again for a previously searched for text string
  3286.  
  3287. At the top of the scrollback screen are a number of icons for the
  3288. above commands.  In addition, there are icons for scrolling up, down,
  3289. paging up and down or moving to the beginning or end of the buffer.
  3290.  
  3291. NOTE: The scrollback buffer filters out ANSI color codes and
  3292.       RIPscrip graphics for an uncluttered text display.
  3293.  
  3294.  
  3295. ┌────────────────────────────────────────────────────────────────────┐
  3296. │                        7.2 ■ THE STATUS BAR                        │
  3297. └────────────────────────────────────────────────────────────────────┘
  3298.  
  3299. At the bottom of the screen is the status bar (normally on).  This
  3300. gives you information about the current configuration of RIPterm.  It
  3301. also provides you with a quick and easy way to access several of the
  3302. basic features of RIPterm without having to use the menus.
  3303.  
  3304. You may toggle the status bar ON and OFF quickly by pressing
  3305. ALT-SPACE.  The host might turn the status bar ON or OFF for you,
  3306. using RIPscrip commands.  If it mysteriously vanishes for some
  3307. reason, keep in mind that the host you are connected to probably did
  3308. it because it needs the extra line for text or graphics!
  3309.  
  3310. There are a number of different "fields" in the Status Bar.  They are:
  3311.  
  3312.         ┌───────────┬─────────────┬──────────┬─────────────────┬
  3313.         │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
  3314.         └───────────┴─────────────┴──────────┴─────────────────┴
  3315.              (1)          (2)          (3)      (4)      (5)
  3316.  
  3317.         ┬──────┬──────────────────┬─────────┐
  3318.         │ COM1 │ RIPterm v1.54.00 │ Offline │
  3319.         ┴──────┴──────────────────┴─────────┘
  3320.           (6)           (7)           (8)
  3321.  
  3322.         (1) How to get the help system table of contents.
  3323.  
  3324.         (2) How to use the keyboard only to select from the menus.
  3325.  
  3326.         (3) What terminal emulation is in use, or the name of the log
  3327.             file if one has been opened or the LPT printer port being
  3328.             used for printer logging.
  3329.  
  3330.         (4) The baud rate, parity setting, data bits and stop bits.
  3331.  
  3332.         (5) Full-duplex (FDX) or half-duplex (HDX) settings.
  3333.  
  3334.         (6) The COM port that is currently in use.
  3335.  
  3336.         (7) The current version number of RIPterm.
  3337.  
  3338.         (8) Whether you are "on-line" or "off-line".
  3339.  
  3340. Each one of the fields just described can be clicked on (if the
  3341. status bar is on).  Once clicked, a different action is performed
  3342. based upon the current state of RIPterm, and what field you clicked
  3343. on.  Each of the various fields are described below:
  3344.  
  3345. ┌────────────────────────┐
  3346. │ HELP TABLE OF CONTENTS │
  3347. └────────────────────────┘
  3348.  
  3349. This option displays the Help Table of Contents.  From here, you can
  3350. access any area in the Help System quickly and easily.
  3351.  
  3352. ┌─────────────────────┐
  3353. │ ACCESSING THE MENUS │
  3354. └─────────────────────┘
  3355.  
  3356. When you click on this option, the menu bar at the top of the screen
  3357. will be highlighted for you.  You may then use the keyboard to
  3358. navigate through the menus quickly and easily to choose options.
  3359.  
  3360. ┌─────────────┐
  3361. │ MISC. FIELD │
  3362. └─────────────┘
  3363.  
  3364. This field serves three purposes.  If you are current logging your
  3365. session to a disk "log file" the filename (without extension) of the
  3366. log file will be displayed in here.  In this mode, clicking in this
  3367. field will close (or pause) the log file.  If you are not logging
  3368. your current session to disk, but to a printer instead, you will see
  3369. this field as something like "--LPT1--" or whatever printer port is
  3370. currently being printed to for session printer logging.  If you are
  3371. not logging your session at all, then this field will display the
  3372. phrase "RIPscrip", indicating that you are using a RIPscrip
  3373. compatible terminal program.  Clicking on this field in this mode
  3374. will bring up a help screen telling you more about RIPscrip graphics
  3375. in general.
  3376.  
  3377. ┌─────────────────────────┐
  3378. │ COMMUNICATIONS SETTINGS │
  3379. └─────────────────────────┘
  3380.  
  3381. This field indicates what the current communications parameters are.
  3382. The baud rate (300-115,200 baud) is displayed as well as the data
  3383. bits (7 or 8), parity ( N = none, E = even and O = odd), and stop
  3384. bits (1 or 2).  If local-echo is enabled, then the phrase "HDX" is
  3385. displayed which means "Half Duplex".  If this is disabled (no echo),
  3386. then the phrase "FDX" is displayed indicating "Full Duplex" mode is
  3387. in effect.
  3388.  
  3389. Clicking on this field brings up the Modem Settings dialog box.
  3390.  
  3391. ┌─────────────────────┐
  3392. │ COMMUNICATIONS PORT │
  3393. └─────────────────────┘
  3394.  
  3395. This field displays what communications port you are using.  Clicking
  3396. on this field brings up the modem settings dialog box.
  3397.  
  3398. ┌─────────────────────┐
  3399. │ RIPTERM INFORMATION │
  3400. └─────────────────────┘
  3401.  
  3402. This field displays the version number of RIPterm that you are
  3403. using.  Clicking on it brings up a help screen corresponding to
  3404. "About RIPterm" in the Project menu.  It displays information about
  3405. the current version of RIPterm.
  3406.  
  3407. ┌────────────────────────────┐
  3408. │ ON-LINE/OFF-LINE INDICATOR │
  3409. └────────────────────────────┘
  3410.  
  3411. This field displays whether you are on-line or off-line. When RIPterm
  3412. is starting up, you might see the phrase "Loading..." in this field;
  3413. this is just a status indicator telling you RIPterm is doing
  3414. something.  The purpose of this field is for you to be able to, at a
  3415. glance, determine if you are still connected to a host or not.  This
  3416. field is updated whenever your on-line status changes in any way
  3417. (providing your modem is configured for carrier detect!).
  3418.  
  3419. Clicking on this field will do one of two things depending on what
  3420. the current on-line/off-line status is.  if you are on-line, clicking
  3421. on this field will ask you if you wish to hang-up (providing you are
  3422. using your modem to connect to a host).  If it says you are off-line,
  3423. clicking on this field will bring up the dialing directory, thus
  3424. allowing you to dial a host.
  3425.  
  3426.  
  3427. ┌────────────────────────────────────────────────────────────────────┐
  3428. │                    7.3 ■ ASCII UPLOAD SETTINGS                     │
  3429. └────────────────────────────────────────────────────────────────────┘
  3430.  
  3431. When you select the ASCII Upload Settings option, the following
  3432. dialog box will appear on your screen:
  3433.  
  3434.                 ╔════════════════════════════════════╗
  3435.                 ║       ASCII Upload Settings        ║
  3436.                 ╟────────────────────────────────────╢
  3437.                 ║                     ┌────┐         ║
  3438.                 ║          Line Delay │ 10 │         ║
  3439.                 ║                     ├────┤         ║
  3440.                 ║     Character Delay │  0 │         ║
  3441.                 ║                     └────┘         ║
  3442.                 ║                     ┌──┐           ║
  3443.                 ║     Blank Expansion │XX│           ║
  3444.                 ║                     └──┘           ║
  3445.                 ║    ┌──────────┐    ┌──────────┐    ║
  3446.                 ║    │    OK    │    │  CANCEL  │    ║
  3447.                 ║    └──────────┘    └──────────┘    ║
  3448.                 ╚════════════════════════════════════╝
  3449.  
  3450. The significance of each field is as follows:
  3451.  
  3452. ┌────────────┐
  3453. │ LINE DELAY │
  3454. └────────────┘
  3455.  
  3456. Sometimes when uploading ASCII files to a host, it is necessary to
  3457. pause in between each line so that the host can process the data.  If
  3458. you find that data is becoming lost, or garbled by the host when you
  3459. perform an ASCII upload, you may need to increase the Line Delay
  3460. option for ASCII uploads.  You may specify a time value in 1/10ths of
  3461. a second.  Therefore, if you specify a value of 11, it would be a 1.1
  3462. second pause in between lines.
  3463.  
  3464. ┌─────────────────┐
  3465. │ CHARACTER DELAY │
  3466. └─────────────────┘
  3467.  
  3468. Under some circumstances, when performing an ASCII upload to a host,
  3469. it is necessary to insert pauses in between each character that is
  3470. sent to the host.  This may be necessary in situations where the host
  3471. must process each character as it is sent, rather than every line of
  3472. text sent.  You may specify a time value in 1/10ths of a second.
  3473. Therefore, if you specify a value of 11, it would be a 1.1 second
  3474. pause in between lines.
  3475.  
  3476. ┌─────────────────┐
  3477. │ BLANK EXPANSION │
  3478. └─────────────────┘
  3479.  
  3480. When this option is chosen, RIPterm will expand blank lines that are
  3481. uploaded in ASCII mode to a space character followed by a carriage
  3482. return.  Under most circumstances, this tricks the BBS into thinking
  3483. that you typed something in, but still shows up as a blank line. This
  3484. is most often the case inside E-Mail editors.  Turn this option off
  3485. if you do not want blank line expansion to be enabled.
  3486.  
  3487.  
  3488. ┌────────────────────────────────────────────────────────────────────┐
  3489. │                         7.4 ■ MACRO EDITOR                         │
  3490. └────────────────────────────────────────────────────────────────────┘
  3491.  
  3492. Macros are functions that you can define to perform short-cut
  3493. operations on the host.  For example, you can instruct RIPterm to
  3494. make the F5 key type your user-id and press <ENTER> for you.  This
  3495. would allow you to log-on quickly by simply pressing a single key.
  3496. RIPterm's macro system is easy to use, and very powerful!  You can
  3497. save your macro keys to the default macro file (RIPTERM.KEY), or if
  3498. you need to have multiple macro configurations, you can save macros
  3499. to different files.
  3500.  
  3501. When you choose the macro editor option, a dialog box similar to the
  3502. following will be displayed:
  3503.  
  3504.    ╔══════════════════════════════════════════════════════════════╗
  3505.    ║                     RIPterm Macro Editor                     ║
  3506.    ║  ┌──────────────────────────────────────┬─┐  ┌────────────┐  ║
  3507.    ║  │  CTRL-F2: This is Macro #1 ......... ││  │    EDIT    │  ║
  3508.    ║  ├──────────────────────────────────────┼─┤  ├────────────┤  ║
  3509.    ║  │    ALT-G: This is Macro #2 ......... │ │  │   DELETE   │  ║
  3510.    ║  ├──────────────────────────────────────┤ │  ├────────────┤  ║
  3511.    ║  │       F2: This is Macro #3 ......... │ │  │    CLEAR   │  ║
  3512.    ║  ├──────────────────────────────────────┤ │  ├────────────┤  ║
  3513.    ║  │ SHIFT-F9: This is Macro #4 ......... │ │  │    SAVE    │  ║
  3514.    ║  ├──────────────────────────────────────┼─┤  ├────────────┤  ║
  3515.    ║  │ CTRL-F10: This is Macro #5 ......... ││  │    LOAD    │  ║
  3516.    ║  └──────────────────────────────────────┴─┘  └────────────┘  ║
  3517.    ║          ┌──────────────┐          ┌──────────────┐          ║
  3518.    ║          │      OK      │          │    CANCEL    │          ║
  3519.    ║          └──────────────┘          └──────────────┘          ║
  3520.    ╚══════════════════════════════════════════════════════════════╝
  3521.  
  3522. The currently defined macros are displayed in the scrolling window on
  3523. the left side of the dialog box.  On the right side, are buttons
  3524. which allow you to add/edit macros, delete existing macros, Clear all
  3525. macros, load a macro file and save all macros to a macro file.
  3526.  
  3527. When selecting macros to edit/delete, you may click on an existing
  3528. macro then click on EDIT or DELETE.  If you wish to edit/delete more
  3529. than one macro at the same time, click on each macro while holding
  3530. down the SHIFT key.  If you click on EDIT without any macros being
  3531. highlighted, you go into ADD macro mode.
  3532.  
  3533. You may store multiple macros into Macro .KEY Files for future use.
  3534. You may have as many macro files as you wish limited only by the
  3535. amount of available disk space.
  3536.  
  3537. ┌──────────────────────────────────────┐
  3538. │ ENTER KEYSTROKE FOR THE MACRO EDITOR │
  3539. └──────────────────────────────────────┘
  3540.  
  3541. Type the keystroke that you wish to record a macro for.  For example,
  3542. if you wanted to record a macro for the F5 key, simply press the F5
  3543. key.  You may specify CTRL, ALT or SHIFT keys as well.  RIPterm's
  3544. macro editor allows you to define literally hundreds of macros using
  3545. nearly as complex a keystroke as you want.  To exit the ADD mode,
  3546. simply press the <SPACE> key.  Beware that you probably would never
  3547. want to make CTRL-M (return), CTRL-H (backspace) or ALT-K (keystroke
  3548. macros) into macros themselves.  This would make it difficult to use
  3549. RIPterm with the keyboard.
  3550.  
  3551. ┌────────────────────────────────────────────┐
  3552. │ TEXT TO SEND HOST WHEN THIS KEY IS PRESSED │
  3553. └────────────────────────────────────────────┘
  3554.  
  3555. Enter the text that should be sent to the host (or the modem) if this
  3556. macro is entered.  In other words, enter the text that you want to be
  3557. associated with this macro.  For example, if you wanted to send the
  3558. text "Hello World" to the host when you press F5, simply type in
  3559. "Hello World".
  3560.  
  3561. You may enter control characters into your macros by using a caret
  3562. (^), followed by the letter of the control key you want to send.  For
  3563. example, a CTRL-C would be represented as ^C.  A carriage return
  3564. (<ENTER>) is specified as ^M.  Also, an ESCAPE is generated by the
  3565. sequence ^[ ... There are a number of different combinations of
  3566. CONTROL CHARACTERS that you may choose from (see the following
  3567. sections for more details).
  3568.  
  3569. In addition to control characters, you can also insert TEXT VARIABLES
  3570. or POPUP LISTS (see below) into your macros.
  3571.  
  3572. ┌──────────────────────────────┐
  3573. │ SAVING YOUR MACROS TO A FILE │
  3574. └──────────────────────────────┘
  3575.  
  3576. Enter the filename that you want to save your defined macros to.  By
  3577. default, the Macro File RIPTERM.KEY is prompted.  If you do not wish
  3578. to store your existing macros as the "Default RIPterm" macros, save
  3579. them to a different file.
  3580.  
  3581. ┌─────────────────────────────────┐
  3582. │ LOADING YOUR MACROS FROM A FILE │
  3583. └─────────────────────────────────┘
  3584.  
  3585. Enter the filename of the macro .KEY file you wish to load.  Macro
  3586. files are contained in the current RIPTERM directory unless otherwise
  3587. specified.  By default, RIPTERM.KEY is prompted, so that you can load
  3588. the default macros quickly and easily.  If you wish to load a custom,
  3589. non-default macro file, simply backspace over the existing filename
  3590. and enter the filename you wish to load.
  3591.  
  3592.  
  3593. ┌────────────────────────────────────────────────────────────────────┐
  3594. │                     7.4.1 ■ CONTROL CHARACTERS                     │
  3595. └────────────────────────────────────────────────────────────────────┘
  3596.  
  3597. Not all hosts will allow you to use control characters.  Regardless
  3598. of that, the capability to send any control character exists in your
  3599. keystroke macro editor.  The most commonly used control characters
  3600. are:
  3601.                                                   
  3602.     INDIVIDUAL CONTROL CHARACTERS                       VALUE
  3603.     ---------------------------------------------------------
  3604.     ^@ ... NUL ... Null byte                              0
  3605.     ^A ... SOH ... Ctrl-A (start of block)                1
  3606.     ^B ... STX ... Ctrl-B (aux. start of block)           2
  3607.     ^C ... ETX ... Ctrl-C (user break)                    3
  3608.     ^D ... EOT ... Ctrl-D (end of transfer)               4
  3609.     ^E ... ENQ ... Ctrl-E (enquire)                       5
  3610.     ^F ... ACK ... Ctrl-F (Acknowledgement)               6
  3611.     ^G ... BEL ... Ctrl-G (bell/beep)                     7
  3612.     ^H ... BS  ... Ctrl-H (backspace)                     8
  3613.     ^I ... HT  ... Ctrl-I (horizontal tab)                9
  3614.     ^J ... LF  ... Ctrl-J (line feed)                     10
  3615.     ^K ... VT  ... Ctrl-K (vertical tab)                  11
  3616.     ^L ... FF  ... Ctrl-L (top of form/clear screen)      12
  3617.     ^M ... CR  ... Ctrl-M (carriage return)               13
  3618.     ^N ... SO  ... Ctrl-N (shift out)                     14
  3619.     ^O ... SI  ... Ctrl-O (shift in)                      15
  3620.     ^P ... DLE ... Ctrl-P                                 16
  3621.     ^Q ... DC1 ... Ctrl-Q (resume data transmission/XON)  17
  3622.     ^R ... DC2 ... Ctrl-R                                 18
  3623.     ^S ... DC3 ... Ctrl-S (pause data transmission/XOFF)  19
  3624.     ^T ... DC4 ... Ctrl-T                                 20
  3625.     ^U ... NAK ... Ctrl-U (no acknowledgement/NAK)        21
  3626.     ^V ... SYN ... Ctrl-V (synchronize byte)              22
  3627.     ^W ... ETB ... Ctrl-W                                 23
  3628.     ^X ... CAN ... Ctrl-X (cancel/CAN)                    24
  3629.     ^Y ... EM  ... Ctrl-Y                                 25
  3630.     ^Z ... SUB ... Ctrl-Z (end of file)                   26
  3631.     ^[ ... ESC ... Escape character (ESC)                 27
  3632.     ^\ ... FS  ...                                        28
  3633.     ^] ... GS  ...                                        29
  3634.     ^_ ... US  ...                                        31
  3635.  
  3636.  
  3637.     SPECIAL KEYSTROKES
  3638.     ----------------------
  3639.     ^[[A ... Up arrow
  3640.     ^[[B ... Down arrow
  3641.     ^[[C ... Right arrow
  3642.     ^[[D ... Left arrow
  3643.     ^[[H ... Home key
  3644.     ^[[K ... End key
  3645.     ^[[L ... Control home
  3646.  
  3647.  
  3648.  
  3649. ┌────────────────────────────────────────────────────────────────────┐
  3650. │                       7.4.2 ■ TEXT VARIABLES                       │
  3651. └────────────────────────────────────────────────────────────────────┘
  3652.  
  3653. A special feature of RIPterm allows it to understand what a text
  3654. variable is.  A text variable is a string of text that RIPterm knows
  3655. represents something more.  For example, the text variable $DATE$ is
  3656. known to represent the current date on your system.  The host may ask
  3657. your system what the values of one or more of these variables are,
  3658. and if your terminal knows that particular text variable, it will
  3659. send that information to the host.
  3660.  
  3661. There are two types of text variables.  There are built-in text
  3662. variables that RIPterm will ALWAYS know about.  Then there are also
  3663. user text variables that can contain a variety of information
  3664. depending on what the RIPterm user entered at the time the variable
  3665. was created.  For example, the host might ask you what the contents
  3666. of the $FULL_NAME$ variable is, and if RIPterm doesn't know, it would
  3667. pop-up a field on the screen and ask you about it.  From then on,
  3668. RIPterm will remember that piece of information for the next time it
  3669. is needed by a host.
  3670.  
  3671. You may use either the pre-defined text variables, or the user text
  3672. variables at any place that allows text variables (i.e., keystroke
  3673. macros).
  3674.  
  3675.  
  3676. ┌────────────────────────────────────────────────────────────────────┐
  3677. │                   7.4.2.1 ■ USER TEXT VARIABLES                    │
  3678. └────────────────────────────────────────────────────────────────────┘
  3679.  
  3680. User text variables are text variables that you create.  A host might
  3681. tell you, "Create this text variable for me", or you might create one
  3682. yourself.  The difference is really unimportant.  However, a brief
  3683. explanation of their purpose might prove insightful.
  3684.  
  3685. User text variables are used to store information either permanently,
  3686. or temporarily.  This information can then be re-used without you
  3687. having to type them in again.  The time-saving aspect of this feature
  3688. is only one small benefit of its ability.  Having the capability to
  3689. store information over potentially long periods of time is VERY
  3690. useful!
  3691.  
  3692. There are three types of user text variables:
  3693.  
  3694. 1. Permanent (database)    variables
  3695. 2. Temporary (in memory)   variables
  3696. 3. Volatile  (discardable) variables
  3697.  
  3698. The significance of each type of variable is described below:
  3699.  
  3700. ┌────────────────────────────────┐
  3701. │ PERMANENT (DATABASE) VARIABLES │
  3702. └────────────────────────────────┘
  3703.  
  3704. Permanent text variables are saved in a local RIPterm database file
  3705. called RIPTERM.DB.  This file is automatically indexed for high-speed
  3706. retrieval of information.  The index file for this database is called
  3707. RIPTERM.IDX.  Both files are stored in the current RIPterm directory
  3708. for safe keeping.  Any permanent text variable that is created is
  3709. stored in this file.
  3710.  
  3711. A permanent text variable can be created by yourself manually by
  3712. choosing option "Store Data" from the Data menu, or interactively by
  3713. a host via a special RIPscrip command ("Define Text Variable").  Once
  3714. you create a variables, they are stored forever, or until you either
  3715. delete the database file, or modify the entry.  These variables may
  3716. be accessed by yourself, or a host (if you wish it).  This can be
  3717. quite useful in preventing you from having to type the same
  3718. information in over and over again in future on-line sessions. Imagine
  3719. if you could sign-up on a host without having to type a single
  3720. character?  Sound too good to be true?  With text variables, you (and
  3721. other sysops) could do this!
  3722.  
  3723. ┌─────────────────────────────────┐
  3724. │ TEMPORARY (IN MEMORY) VARIABLES │
  3725. └─────────────────────────────────┘
  3726.  
  3727. Temporary (in memory) text variables are just like permanent text
  3728. variables, except that they are not stored in a database file.  They
  3729. are stored in your computer's memory.  They remain until you exit
  3730. RIPterm.  Other than that, they are identical in nature to permanent
  3731. text variables.  Until you exit RIPterm, they will exist and will be
  3732. accessible to you (via macros), or to a host.
  3733.  
  3734. ┌──────────────────────────────────┐
  3735. │ VOLATILE (DISCARDABLE) VARIABLES │
  3736. └──────────────────────────────────┘
  3737.  
  3738. A volatile (discardable) text variable is somewhat different than the
  3739. previously described text variables.  They do not remain in memory or
  3740. in any database for any period of time.  They are used solely to ask
  3741. you a simple question, transmit the information to the host, then the
  3742. contents of the variable are destroyed forever.  Why would you (or a
  3743. host) want something like this?  This question is answered
  3744. differently for YOU or for a host.
  3745.  
  3746. A volatile text variable for you can be useful during keystroke
  3747. macros.  Let's say you have a very complex macro that you've devised
  3748. for doing something in a game (for example) to another user on the
  3749. host.  Should you have to edit the macro each time you want to
  3750. use it for someone different?  Of course not!  Simply place a
  3751. reference to an "undefined" text variable in your macro.  When you
  3752. execute the macro, RIPterm will look through its list of text
  3753. variables (pre-defined, in-memory and permanent), and if it doesn't
  3754. find a corresponding variable, it would pop-up a quick dialog box
  3755. asking you to enter something for that variable.  Whatever you type
  3756. into that dialog box for the variable is replaced in your macro right
  3757. then and there, and is immediately discarded after the macro is
  3758. finished.  For example, let's say you have the following macro setup
  3759. to attack another player in a game on some host you call:
  3760.  
  3761.     F2:  ATTACK $USERNAME$ FIERCELY^m
  3762.  
  3763. When you execute macro F2, RIPterm will transmit "ATTACK " to the
  3764. host, then find the text variable $USERNAME$ in it.  It will check
  3765. its internal tables for this variable, and if it doesn't find it, it
  3766. will pop-up a window asking you to enter the following:
  3767.  
  3768.       ╔════════════════════════════════════════════════════════╗
  3769.       ║                Please enter "USERNAME"                 ║
  3770.       ║  ┌──────────────────────────────────────────────────┐  ║
  3771.       ║  │ █                                                │  ║
  3772.       ║  └──────────────────────────────────────────────────┘  ║
  3773.       ╚════════════════════════════════════════════════════════╝
  3774.  
  3775. Simply type in the name of the user you wish to attack, and the
  3776. result will be sent to the host in place of the variable name
  3777. $USERNAME$.  After that, the remainder of the macro will be
  3778. transmitted to the host (i.e., " FIERCELY") followed by a carriage
  3779. return (^M is the carriage return).  Once the macro is complete, the
  3780. contents of USERNAME will not exist (unless it was a previously
  3781. defined "permanent" text variable or a Temporary (in memory) text
  3782. variable.
  3783.  
  3784. A host can also ask you to enter something for a volatile text
  3785. variable.  Why would a host want to do this and not save the response
  3786. somewhere?  What if you asked a host to download a file.  It could
  3787. present you with a menu like the following:
  3788.  
  3789.             ╔═══════════════════════════════════════════╗
  3790.             ║                File Download              ║
  3791.             ║  ┌─────────────┐  ┌────────────────────┐  ║
  3792.             ║  │  Protocols  │  │   Enter Filename   │  ║
  3793.             ║  ├─────────┬───┤  └────────────────────┘  ║
  3794.             ║  │ X-Modem │   │  ╔════════════════════╗  ║
  3795.             ║  │ Y-Modem │   │  ║   Begin Download   ║  ║
  3796.             ║  │ Z-Modem │ X │  ╚════════════════════╝  ║
  3797.             ║  │ Kermit  │   │  ┌────────────────────┐  ║
  3798.             ║  └─────────┴───┘  │  Cancel Download!  │  ║
  3799.             ║                   └────────────────────┘  ║
  3800.             ╚═══════════════════════════════════════════╝
  3801.  
  3802. The options on the left allow you to specify the file transfer
  3803. protocol that you wish to use for the transfer.  The "Enter Filename"
  3804. button though is the one we're interested in.  When you click on this
  3805. button, you would think that RIPterm should pop-up a dialog box on
  3806. your screen asking you what filename you want to download, right?
  3807. Would you think that the filename you enter should become a permanent
  3808. part of RIPterm's configuration?  Of course not.  It saved only
  3809. temporarily until such time as you click on either "Begin Download"
  3810. or "Cancel Download!".  Its value is used specifically when you click
  3811. on "Begin Download" whereby RIPterm looks at all of the buttons on
  3812. the screen and instructs the host to begin the download in a certain
  3813. way (e.g., using Z-Modem protocol to download file XYZ.EXE for
  3814. example).  As you can clearly see, you would not want the filename
  3815. field to be part of your permanent RIPterm configuration.  In this
  3816. manner, volatile text variables can be extremely useful!
  3817.  
  3818.  
  3819. ┌────────────────────────────────────────────────────────────────────┐
  3820. │               7.4.2.2 ■ USER TEXT VARIABLE SECURITY                │
  3821. └────────────────────────────────────────────────────────────────────┘
  3822.  
  3823. All this discussion about user text variables, and hosts asking your
  3824. terminal for information, you might be concerned about calling some
  3825. host you've never called before and letting it ask your terminal
  3826. questions about itself (and YOU)!  We don't blame you for thinking
  3827. this.  That is why we've put a security precaution into RIPterm.  It
  3828. is called "Data Security".  This option (available from the Data
  3829. menu) allows you to preview any user text variable question to
  3830. determine if you really and truly want to send that information to
  3831. the host.  This allows you to edit the text variable that will be
  3832. sent to the host so that you are in control at all times of what
  3833. information is sent to the host.  Any variable that is queried by the
  3834. host will be prompted on your screen allowing you to edit the
  3835. response.  In the event that you do not wish to divulge the
  3836. information to the host, simply backspace over your text and send a
  3837. "blank" response.  In the event that the host won't permit a blank
  3838. response, enter something like "NONE" or "N/A".
  3839.  
  3840. If this mode is disabled, you may still be prompted to edit your
  3841. variable if the host asks for an "interactive query".  The host can
  3842. ask for a non-interactive text variable query, which means that the
  3843. host will "try" to ask your terminal the contents of a text variable.
  3844. If the variable exists, it will send the contents to the host without
  3845. you even knowing that it was sent!  In some ways, it is up to the
  3846. honor of the sysop of the host to set all variable queries as
  3847. interactive by default.  But considering the fact that this is not an
  3848. entirely "equal" world, having the ability to override variable
  3849. queries with a Data Security option becomes quite important.
  3850.  
  3851. This option defaults to "ON" when RIPterm is initially installed.  In
  3852. other words, all data queries are considered "secure" by default.  It
  3853. is up to you to disable this security measure.  Use this option with
  3854. caution if you're not sure about trusting the hosts you call.
  3855.  
  3856. As a note worth mentioning, a RIPscrip command to query the contents
  3857. of your terminal's text variables may be possible if you read an
  3858. electronic mail message from an ingenious user who knows the RIPscrip
  3859. protocol language.  In situations like this, you would definitely
  3860. want to use data security mode to prevent unauthorized information
  3861. transmittal to other people (e.g., credit card numbers, or other
  3862. information).
  3863.  
  3864.  
  3865. ┌────────────────────────────────────────────────────────────────────┐
  3866. │                7.4.2.3 ■ PRE-DEFINED TEXT VARIABLES                │
  3867. └────────────────────────────────────────────────────────────────────┘
  3868.  
  3869. Pre-defined text variables are something that RIPterm always knows
  3870. about.  They are "built-in" to RIPterm, and a host can always get an
  3871. answer to.  These types of variables are defined to provide the host
  3872. with some kind of information about your terminal software, not about
  3873. something you (or your terminal) knows.  In other words, pre-defined
  3874. text variables can be used to send a piece of information to the host
  3875. saying "what time is it", or "what is the date where you are", or
  3876. "where is the mouse located?".  They function exactly like any other
  3877. text variable except that RIPterm knows they exist even if you
  3878. haven't created them yet. By nature, the values that these variables
  3879. return to the host are rarely the same.  They change depending on the
  3880. nature of each variable.
  3881.  
  3882. The following is a list of pre-defined text variables:
  3883.  
  3884.  
  3885.     $DATE$ ... Date in short format (e.g., 12/19/92)
  3886.  
  3887.     This Text Variable will be transformed into the current Date.
  3888.     It will be displayed in the format MM/DD/YY.
  3889.  
  3890.         Example:  $DATE$ = 12/19/92
  3891.  
  3892.     -----------------------------------------------------------------
  3893.  
  3894.     $MONTH$ ... Month Name
  3895.  
  3896.     This text variable will be transformed into the name of the
  3897.     current month.  It will be not abbreviated (e.g., "November"
  3898.     instead of "Nov")
  3899.  
  3900.         Example:  $MONTH$ = December
  3901.  
  3902.     -----------------------------------------------------------------
  3903.  
  3904.     $MONTHNUM$ ... Month (in format 1-12)
  3905.  
  3906.     This text variable is transformed into a number representing
  3907.     the current month.  January=01 and December=12.  Therefore,
  3908.     the possible values for $MONTHNUM$ can range from 1 to 12.
  3909.  
  3910.         Example:  $MONTHNUM$ = 12
  3911.  
  3912.     -----------------------------------------------------------------
  3913.  
  3914.     $DAY$ ... Day in numeric form (e.g., 31)
  3915.  
  3916.     This text variable is transformed into a number representing the
  3917.     day of the month.  The range of values for this variable are from
  3918.     01-31.
  3919.  
  3920.         Example:  $DAY$ = 05
  3921.  
  3922.     -----------------------------------------------------------------
  3923.  
  3924.     $DOY$ ... Day of year (001-366)
  3925.  
  3926.     This text variable will be transformed into a number representing
  3927.     the day of the current year.  Since a year contains 365 days
  3928.     (unless it is a leap-year where it contains 366), then the
  3929.     possible values that $DOY$ can be are 001-366.
  3930.  
  3931.         Example: $DOY$ = 214
  3932.  
  3933.     -----------------------------------------------------------------
  3934.  
  3935.     $YEAR$ ... 2 digit year (without century) (00-99)
  3936.  
  3937.     This text variable will be transformed into a two-digit number
  3938.     representing the current year.
  3939.  
  3940.         Example: $YEAR$ = 92
  3941.  
  3942.     -----------------------------------------------------------------
  3943.  
  3944.     $FYEAR$ ... 4 digit year (with century) (0000-9999)
  3945.  
  3946.     This text variable will be transformed into a four-digit number
  3947.     that represents the current year.
  3948.  
  3949.         Example:  $FYEAR$ = 1992
  3950.  
  3951.     -----------------------------------------------------------------
  3952.  
  3953.     $TIME$ ... Time in standard format (e.g., 12:03:14)
  3954.  
  3955.     This text variable will be transformed into the current time.
  3956.     The time will be in military format (hours from 00-23).
  3957.  
  3958.         Example:  $TIME$ = 18:09:33
  3959.  
  3960.     -----------------------------------------------------------------
  3961.  
  3962.     $HOUR$ .... Hour (format HH) - normal style
  3963.  
  3964.     This text variable will be transformed into a two-digit number
  3965.     representing the current hour.  This variable may be anywhere
  3966.     from 01-12.  This does not use military format.
  3967.  
  3968.         Example:  $HOUR$ = 11
  3969.  
  3970.     -----------------------------------------------------------------
  3971.  
  3972.     $MHOUR$ ... Hour (format HH) - Military style
  3973.  
  3974.     This text variable will be transformed into a two-digit number
  3975.     representing the current hour in military format.  This variable
  3976.     may range anywhere from 00-23.
  3977.  
  3978.         Example: $MHOUR$ = 17
  3979.  
  3980.     -----------------------------------------------------------------
  3981.  
  3982.     $MIN$ ... Minutes (00-59)
  3983.  
  3984.     This text variable will be transformed into a two-digit number
  3985.     representing the current minutes in the hour.  Possible values
  3986.     for this variable are 00-59.
  3987.  
  3988.         Example:  $MIN$ = 45
  3989.  
  3990.     -----------------------------------------------------------------
  3991.  
  3992.     $SEC$ ... Seconds (00-59)
  3993.  
  3994.     This text variable will be transformed into a two-digit number
  3995.     representing the current seconds of the minute.  Possible values
  3996.     for this variable are 00-59.
  3997.  
  3998.         Example: $SEC$ = 59
  3999.  
  4000.     -----------------------------------------------------------------
  4001.  
  4002.     $AMPM$ ... Returns either AM or PM depending on time
  4003.  
  4004.     This text variable will be transformed into a two-character
  4005.     value of either "AM" or "PM" depending on what time it is.
  4006.  
  4007.         Example: $AMPM$ = PM
  4008.  
  4009.     -----------------------------------------------------------------
  4010.  
  4011.     $DATETIME$ ... Date & Time (e.g., Sat Dec 19 14:38:50 1992)
  4012.  
  4013.     This text variable will be transformed into a combination date
  4014.     and time.  The format is somewhat different than standard
  4015.     time/date notation.  The format used is:
  4016.  
  4017.         DAY-OF-WEEK   MONTH   DAY-OF-MONTH  HH:MM:SS  YEAR
  4018.  
  4019.         Example:  $DATETIME$ = Sat Dec 19 14:38:50 1992
  4020.  
  4021.     -----------------------------------------------------------------
  4022.  
  4023.     $TIMEZONE$ ... Time Zone or "NONE" if unknown (e.g., Pacific)
  4024.  
  4025.     This text variable will be transformed into a a word/phrase that
  4026.     describes the current time-zone you are in.  This may be returned
  4027.     as anything like "PST" for Pacific Standard Time, "EDT" for
  4028.     Eastern Daylight Time, etc.  If the time-zone is not set on your
  4029.     system, this variable will respond with "NONE".
  4030.  
  4031.         Example: $TIMEZONE$ = PST
  4032.  
  4033.     -----------------------------------------------------------------
  4034.  
  4035.     $DOW$ ... Day of week fully spelled out (e.g., Friday)
  4036.  
  4037.     This text variable will be transformed into the current day
  4038.     of the week.  The name will be fully spelled out.  This
  4039.     variable can be any of the values: Sunday, Monday, Tuesday,
  4040.     Wednesday, Thursday, Friday and Saturday.
  4041.  
  4042.         Example:  $DOW$ = Saturday
  4043.  
  4044.     -----------------------------------------------------------------
  4045.  
  4046.     $ADOW$ ... Abbreviated Day of Week (e.g., Mon, Tue, etc.)
  4047.  
  4048.     This text variable will be transformed into the current day
  4049.     of the week, in abbreviated form.  This variable may be any
  4050.     of the following values: Sun, Mon, Tue, Wed, Thu, Fri and Sat.
  4051.  
  4052.         Example:  $ADOW$ = Mon
  4053.  
  4054.     -----------------------------------------------------------------
  4055.  
  4056.     $WDAY$ ... Weekday where 0 is Sunday (0-6)
  4057.  
  4058.     This text variable will be transformed into a one-digit number
  4059.     representing the number of the day of the week.  Possible values
  4060.     for this variable are 0-6, where 0=Sunday (the first day in the
  4061.     week).
  4062.  
  4063.         Example: $WDAY$ = 2
  4064.  
  4065.     -----------------------------------------------------------------
  4066.  
  4067.     $WOY$ ... Week of current year 00-53; Sunday=1st Day of Week
  4068.  
  4069.     This text variable will be transformed into a number from 00-53,
  4070.     representing the week number in the current year.  Even though
  4071.     there are 52 weeks in a year, a week might not begin exactly on
  4072.     the first day of the year, so a maximum value for this variable
  4073.     can be 53 under these circumstances.  For this variable, SUNDAY
  4074.     is considered to be the first day of the week.
  4075.  
  4076.         Example:  $WOY$ = 32
  4077.  
  4078.     -----------------------------------------------------------------
  4079.  
  4080.     $WOYM$ ... Week of current year 00-53; Monday=1st Day of Week
  4081.  
  4082.     This text variable will be transformed into a number from 00-53,
  4083.     representing the week number in the current year.  Even though
  4084.     there are 52 weeks in a year, a week might not begin exactly on
  4085.     the first day of the year, so a maximum value for this variable
  4086.     can be 53 under these circumstances.  For this Variable, MONDAY
  4087.     is considered to be the first day of the week.
  4088.  
  4089.         Example:  $WOYM$ = 32
  4090.  
  4091.     -----------------------------------------------------------------
  4092.  
  4093.     $RIPVER$ ... RIPscrip version (e.g., "RIPSCRIP015400")
  4094.  
  4095.     This text variable will be transformed into a key-phrase which
  4096.     will identify a RIPscrip software package.  It is designed to
  4097.     be used by a host to detect what version of RIPscrip
  4098.     graphics your terminal can support.  When this text variable
  4099.     is used, it will respond back with "RIPSCRIP" followed by
  4100.     the full version number (e.g., 01.54.00), without the periods.
  4101.  
  4102.         Example: $RIPVER$ = RIPSCRIP015400
  4103.  
  4104.     -----------------------------------------------------------------
  4105.  
  4106.     $STATBAR$ ... If Status Bar is on, returns YES, otherwise NO
  4107.  
  4108.     This text variable will be transformed into a "YES" if the status
  4109.     bar is currently ON.  If the Status Bar is not visible, then this
  4110.     variable will be "NO".
  4111.  
  4112.         Example:  $STATBAR$ = YES
  4113.  
  4114.     -----------------------------------------------------------------
  4115.  
  4116.     $X$ ... X Mouse location   (format: XXXX)
  4117.  
  4118.     This text variable is for reporting the current X location of
  4119.     the mouse to the host.  This could be used interactively by the
  4120.     host (or a game on the host) to determine the location of the
  4121.     mouse cursor.  Only the X value of the mouse (X,Y) location is
  4122.     returned to the host.  The value will be 0000-9999 depending on
  4123.     what the current position is.
  4124.  
  4125.         Example:  $X$ = 0523
  4126.  
  4127.     -----------------------------------------------------------------
  4128.  
  4129.     $Y$ ... Y Mouse location   (format: YYYY)
  4130.  
  4131.     This text variable is for reporting the current Y location of
  4132.     the mouse to the host.  This could be used interactively by the
  4133.     host (or a game on the host) to determine the location of the
  4134.     mouse cursor.  Only the Y value of the mouse (X,Y) location is
  4135.     returned to the host.  The value will be 0000-9999 depending on
  4136.     what the current position is.
  4137.  
  4138.         Example:  $Y$ = 0244
  4139.  
  4140.     -----------------------------------------------------------------
  4141.  
  4142.     $XY$ ... X/Y Mouse Location (format: XXXX:YYYY)
  4143.  
  4144.     This text variable will be transformed into a combination of
  4145.     both the X and Y locations of the mouse.  A colon (:) is used to
  4146.     separate the two values.  Either the X or Y values may range from
  4147.     0000-9999 depending on the current location.  The format that
  4148.     this value takes on is:  XXXX:YYYY
  4149.  
  4150.         Example:  $XY$ = 0297:0321
  4151.  
  4152.     -----------------------------------------------------------------
  4153.  
  4154.     $XYM$ ... X, Y & button status (format: XXXX:YYYY:LMR)
  4155.  
  4156.     This text variable will be transformed into a combination of the
  4157.     X and Y mouse location, and a status of which mouse buttons are
  4158.     pressed (if any).
  4159.  
  4160.     The format of the returned text is XXXX:YYYY:LMR where XXXX is
  4161.     the X cursor location in the range 0000-9999.  YYYY is the Y
  4162.     cursor location in the range 0000-9999.  Finally, LMR stands for
  4163.     Left/Middle/Right.  If either of these buttons are depressed
  4164.     (clicked), then the corresponding position will contain a 1.  If
  4165.     a button is NOT depressed, then it will contain a 0.
  4166.  
  4167.         Example:  $XYM$ = 0123:0297:110
  4168.  
  4169.     This means that the (X,Y) location of the cursor is (0123,0297),
  4170.     and that the left and middle buttons are depressed, but that the
  4171.     right mouse button is not depressed.
  4172.  
  4173.     -----------------------------------------------------------------
  4174.  
  4175.     $M$ ... Mouse Button Status: LMR (e.g., 101)
  4176.  
  4177.     This text variable will be transformed into a 3-character code
  4178.     representing what the status of each mouse button is.  This
  4179.     variable can work with either 2-button mice, or 3-button mice.
  4180.     In either event, the format of the code is LMR where L = Left,
  4181.     M = Middle (if any), and R = Right.  If any of these buttons are
  4182.     depressed (i.e., clicked), then the code for that button would be
  4183.     a "1".  If the button is not depressed, it is a "0".  So, a value
  4184.     of "100" would mean that the left mouse button is depressed, but
  4185.     none of the others are.
  4186.  
  4187.         Example:  $M$ = 001
  4188.  
  4189.     -----------------------------------------------------------------
  4190.  
  4191.     $MSTAT$ ... Mouse Status (format: YES/NO)
  4192.  
  4193.     This text variable will be transformed into a "YES" if there is
  4194.     a mouse installed on the RIPterm computer.  If no mouse is
  4195.     installed, this variable will contain "NO".
  4196.  
  4197.         Example:  $MSTAT$ = YES
  4198.  
  4199.     -----------------------------------------------------------------
  4200.  
  4201.     TWH ... Current text window's height
  4202.  
  4203.     This variable returns the height of the currently active text
  4204.     window.  If the window is Disabled, then the height will be 0.
  4205.  
  4206.         Example:  $TWH$ = 25
  4207.  
  4208.     -----------------------------------------------------------------
  4209.  
  4210.     TWW ... Current text window's width
  4211.  
  4212.     This variable returns the width of the currently active text
  4213.     window.  If the window is Disabled, then the width will be 0.
  4214.  
  4215.         Example:  $TWW$ = 80
  4216.  
  4217.     -----------------------------------------------------------------
  4218.  
  4219.     TWX0 ... Upper-left X coordinate of text window
  4220.  
  4221.     This variable returns the upper-left X coordinate of the text window.
  4222.     This value is 0-based and can range from 0-90.  If the window is
  4223.     disabled, it will result in 0.
  4224.  
  4225.         Example:  $TWX0$ = 5
  4226.  
  4227.     -----------------------------------------------------------------
  4228.  
  4229.     TWY0 ... Upper-left Y coordinate of text window
  4230.  
  4231.     This variable returns the upper-left Y coordinate of the text window.
  4232.     This value is 0-based and can range from 0-42.  If the window is
  4233.     disabled, it will result in 0.
  4234.  
  4235.         Example:  $TWY0$ = 3
  4236.  
  4237.     -----------------------------------------------------------------
  4238.  
  4239.     TWX1 ... Lower-right X coordinate of text window
  4240.  
  4241.     This variable returns the lower-right X coordinate of the text window.
  4242.     This value is 0-based and can range from 0-90.  If the window is
  4243.     disabled, it will result in 0.
  4244.  
  4245.         Example:  $TWX1$ = 75
  4246.  
  4247.     -----------------------------------------------------------------
  4248.  
  4249.     TWY1 ... Lower-right Y coordinate of text window
  4250.  
  4251.     This variable returns the lower-right Y coordinate of the text window.
  4252.     This value is 0-based and can range from 0-42.  If the window is
  4253.     disabled, it will result in 0.
  4254.  
  4255.         Example:  $TWY1$ = 23
  4256.  
  4257.     -----------------------------------------------------------------
  4258.  
  4259.     TWWIN ... Returns YES if text window active, otherwise NO
  4260.  
  4261.     If the text window is currently active, this variable returns a
  4262.     value of "YES".  If it is disabled, it returns a "NO".
  4263.  
  4264.         Example:  $TWWIN$ = YES
  4265.  
  4266.     -----------------------------------------------------------------
  4267.  
  4268.     TWFONT ... Current System Font number in use or 0 for none
  4269.  
  4270.     This variable returns the current MicroANSI font number + 1.
  4271.     If the text window is disabled, then no MicroANSI font applies
  4272.     and the variable will result in 0.  A value of 1 indicates an
  4273.     8x8 MicroANSI font, a value of 2 indicates a 7x8 field, and
  4274.     so on.  Subtract 1 from the value to obtain the correct MicroANSI
  4275.     font index number (providing the text window is active).
  4276.  
  4277.         Example:  $TWFONT$ = 1
  4278.  
  4279.     -----------------------------------------------------------------
  4280.  
  4281.     CURX ... Returns the current X cursor coordinate
  4282.  
  4283.     If the current text window is disabled, this variable returns 0.
  4284.     If it is active, it returns the current X position of the cursor
  4285.     in the range of 1-91.
  4286.  
  4287.         Example:  $CURX$ = 18
  4288.  
  4289.     -----------------------------------------------------------------
  4290.  
  4291.     CURY ... Returns the current Y cursor coordinate
  4292.  
  4293.     If the current text window is disabled, this variable returns 0.
  4294.     If it is active, it returns the current Y position of the cursor
  4295.     in the range of 1-42.
  4296.  
  4297.         Example:  $CURY$ = 21
  4298.  
  4299.  
  4300.     -----------------------------------------------------------------
  4301.  
  4302.     CURSOR ... Returns YES if the cursor is visible, otherwise NO
  4303.  
  4304.     If the text cursor is displayed this variable returns a "YES".
  4305.     If the text window is disabled, or the cursor is off, it returns
  4306.     a "NO".
  4307.  
  4308.         Example:  $CURSOR$ = YES
  4309.  
  4310.     ┌───────────────────────┐
  4311.     │ Active Text Variables │
  4312.     └───────────────────────┘
  4313.  
  4314.     These text variables are somewhat different than the other text
  4315.     variables described above.  Rather than send something back to
  4316.     the host, it performs a specific operation, such as toggling the
  4317.     status line.  In this respect, it is considered an ACTIVE TEXT
  4318.     VARIABLE.  It evaluates to a null string (nothing).
  4319.  
  4320.  
  4321.     $SBARON$ ... Turn ON the Status Line
  4322.  
  4323.     This text variable's sole purpose in life is to enable the Status
  4324.     Line.  It evaluates to a null string (nothing).
  4325.  
  4326.     -----------------------------------------------------------------
  4327.  
  4328.     $SBAROFF$ ... Turn OFF the Status Line
  4329.  
  4330.     This text variable's sole purpose in life is to disable the Status
  4331.     Line.  It evaluates to a null string (nothing).
  4332.  
  4333.     -----------------------------------------------------------------
  4334.  
  4335.     $ETW$ ... Erase Text Window
  4336.  
  4337.     This command erases the current text window (much like a clear
  4338.     screen code does).  This command is particularly useful in host
  4339.     commands when you click on a mouse area, and after it is finished
  4340.     clicking, it could erase the text window THEN transmit the
  4341.     remainder of the host command (if any) to the host.
  4342.  
  4343.     -----------------------------------------------------------------
  4344.  
  4345.     $DTW$ ... Disable Text Window
  4346.  
  4347.     This text variable disables the current text window (preventing
  4348.     any received text from showing up on screen).
  4349.  
  4350.     -----------------------------------------------------------------
  4351.  
  4352.     $EGW$ ... Erase Graphics Window
  4353.  
  4354.     This text variable it erases the current graphics window (much
  4355.     like a reset windows command does).  This command is particularly
  4356.     useful in host commands when you click on a mouse area, and after
  4357.     it is finished clicking, it could erase the graphics window THEN
  4358.     transmit the remainder of the host command (if any) to the host.
  4359.  
  4360.     -----------------------------------------------------------------
  4361.  
  4362.     $MKILL$ ... Kill all Mouse Fields currently defined
  4363.  
  4364.     This text variable deletes all currently defined mouse fields
  4365.     exactly like the RIPscrip RIP_KILL_MOUSE_FIELDS command does. The
  4366.     net benefit of this is that when the user clicks on a mouse
  4367.     button, the mouse fields are removed, but the graphics remain on
  4368.     the screen so that the fields could be subsequently re-defined
  4369.     quickly and easily without having to re-transmit an identical
  4370.     menu over again.
  4371.  
  4372.     -----------------------------------------------------------------
  4373.  
  4374.     $BEEP$ ... Beeps the terminal (like a CTRL-G does)
  4375.  
  4376.     This command issues a beep to the terminal, thus producing
  4377.     a CTRL-G sound.
  4378.  
  4379.     -----------------------------------------------------------------
  4380.  
  4381.     $BLIP$ ... Makes a short "blipping" sound
  4382.  
  4383.     This active text variable is much like the BEEP variable, except
  4384.     that the sound produced is different.  It produces a sound more
  4385.     akin to a "barrier" sound; something that sounds like you're
  4386.     bumping into a wall or something to that effect.
  4387.  
  4388.     -----------------------------------------------------------------
  4389.  
  4390.     $MUSIC$ ... Makes a musical (cheerful) sound
  4391.  
  4392.     This active text variable also produces an audio result.  The
  4393.     sound that is generated is a cheerful sound, representing some
  4394.     kind of success.  The sound is exactly the same as the sound you
  4395.     would hear when you receive a successful download, or when you
  4396.     achieve a connection when dialing the modem in RIPterm.
  4397.  
  4398.     -----------------------------------------------------------------
  4399.  
  4400.     $ALARM$ ... Makes an alarm-like warning sound
  4401.  
  4402.     When executed, this variable will issue a sound that gives you
  4403.     the impression that something is definitely wrong.  It is
  4404.     the same sound that RIPterm will use when a download fails for
  4405.     some reason.
  4406.  
  4407.     -----------------------------------------------------------------
  4408.  
  4409.     $PHASER$ ... Makes a space-like Phaser Sound
  4410.  
  4411.     This variable will produce a descending continuous tone from
  4412.     2500 hertz down to 50 hertz.  The transition is very smooth and
  4413.     makes it seem like some spaceship is firing its phasers at you.
  4414.  
  4415.     -----------------------------------------------------------------
  4416.  
  4417.     $REVPHASER$ ... The exact reverse sound of $PHASER$
  4418.  
  4419.     This text variable is identical in nature to the $PHASER$
  4420.     variable except that the sound is produced in the opposite order
  4421.     (ie, an ascending phaser-like sound).
  4422.  
  4423.     -----------------------------------------------------------------
  4424.  
  4425.     $PCB$ ... Paste Clip Board at last location
  4426.  
  4427.     This command pastes the contents of the clipboard at the last
  4428.     location where the clipboard was "clipped" from.  This even works
  4429.     with icons that are loaded.  The last location taken in this
  4430.     situation, is the location the icon was stamped when it was
  4431.     originally loaded.  This text variable is very useful in
  4432.     situations where you want to "pop-up" a dialog box on the screen
  4433.     (saving the previous area behind the dialog onto the clipboard),
  4434.     and when the user clicks on the "OK" button, restoring the screen
  4435.     contents (by adding a $PCB$ in the host command string).
  4436.  
  4437.     -----------------------------------------------------------------
  4438.  
  4439.     $SMF$ ... Save Mouse Fields
  4440.  
  4441.     This text variable will save all currently defined mouse fields
  4442.     and mouse buttons to a temporary file for later retrieval.  This
  4443.     is designed especially for the graphical designer who wishes to
  4444.     pop-up a dialog box on the screen with one or more mouse fields,
  4445.     and when finished, to restore the screen and original mouse
  4446.     fields (if any) so that the user is not left "floating".  This
  4447.     command is intended to be used with the restore mouse fields text
  4448.     variable $RMF$.
  4449.  
  4450.     -----------------------------------------------------------------
  4451.  
  4452.     $RMF$ ... Restore Mouse Fields
  4453.  
  4454.     This text variable restores any previously saved mouse fields
  4455.     saved with the $SMF$ text variable.  You may have only one set of
  4456.     mouse fields saved at any one time.  If there were no mouse
  4457.     fields saved, or if the number of mouse fields that were saved
  4458.     was 0, then no mouse fields will be active.  Any fields that were
  4459.     defined at the time of this command's execution will be erased.
  4460.     Due to technical details, this should be the last piece of text
  4461.     or the last text variable in any mouse host command (or button
  4462.     host command). Having subsequent text variables or host command
  4463.     text after this variable (in a mouse field) can lead to
  4464.     unpredictable and potentially disastrous results.
  4465.  
  4466.     NOTE: You may restore mouse fields more than once if you wish.
  4467.           In other words, if you perform a "Save Mouse Fields"
  4468.           command, you may execute Restore Mouse Fields one or
  4469.           more times after that point.
  4470.  
  4471.     -----------------------------------------------------------------
  4472.  
  4473.     $COFF$ ... Disable the text cursor
  4474.  
  4475.     This command will physically shut off the ASCII text cursor that
  4476.     is normally seen in the text window.  This is automatically reset
  4477.     whenever a $CON$ command (Cursor ON) or a Reset Windows command
  4478.     is received.
  4479.  
  4480.     -----------------------------------------------------------------
  4481.  
  4482.     $CON$ ... Re-displays the text cursor
  4483.  
  4484.     This command will physically turn ON the ASCII text cursor.  This
  4485.     is the exact opposite of the $COFF$ command which disables the
  4486.     text cursor.
  4487.  
  4488.     -----------------------------------------------------------------
  4489.  
  4490.     $STW$ ... Save text window information
  4491.  
  4492.     This command will physically store all of the text window
  4493.     settings.  The window's X/Y dimensions are preserved, as is the
  4494.     current cursor location, ANSI attributes, cursor ON/OFF status
  4495.     and the vertical scrolling margins.  Even the current System Font
  4496.     will be saved (if necessary).
  4497.  
  4498.     -----------------------------------------------------------------
  4499.  
  4500.     $RTW$ ... Restore text window information
  4501.  
  4502.     This command will restore the text window to whatever settings
  4503.     were active when the $STW$ (save text window) command was issued.
  4504.     The cursor, ANSI attributes and any other piece of text window
  4505.     information will be restored (including the System Font setting).
  4506.  
  4507.     -----------------------------------------------------------------
  4508.  
  4509.     $SCB$ ... Save Clip Board
  4510.  
  4511.     This command will save the Clipboard to disk for later retrieval
  4512.     by a subsequent Query or Host Command.  If the clipboard does
  4513.     not exist, then the temporary file is deleted automatically to
  4514.     indicate to the Restore Clip Board that there shouldn't be a
  4515.     clipboard active.
  4516.  
  4517.     -----------------------------------------------------------------
  4518.  
  4519.     $RCB$ ... Restore Clip Board
  4520.  
  4521.     This command restores the clipboard from the temporary disk file
  4522.     called RIPCLIP.BRD.  This file is created by $SCB$ (save clip
  4523.     board).  Not only is the actual clipboard contents saved, but
  4524.     so is the last clipboard location, so that the Paste Clip Board
  4525.     command ($PCB$) will restore the clipboard's location as well.
  4526.  
  4527.     -----------------------------------------------------------------
  4528.  
  4529.     $VT102ON$ ... Turn VT-102 emulation mode ON
  4530.  
  4531.     This command enabled the VT-102 terminal emulation mode.  This
  4532.     makes the following keystrokes send something to the Host:
  4533.  
  4534.                               F1 ...  ESC [ M
  4535.                               F2 ...  ESC [ N
  4536.                               F3 ...  ESC [ O
  4537.                               F4 ...  ESC [ P
  4538.                               F5 ...  ESC [ Q
  4539.                               F6 ...  ESC [ R
  4540.                               F7 ...  ESC [ S
  4541.                               F8 ...  ESC [ T
  4542.                               F9 ...  ESC [ U
  4543.                              F10 ...  ESC [ V
  4544.                             PGUP ...  ESC [ I
  4545.                             PGDN ...  ESC [ G
  4546.                             HOME ...  ESC [ H
  4547.                              END ...  ESC [ F
  4548.                           INSERT ...  ESC [ L
  4549.                        CURSOR UP ...  ESC [ A
  4550.                        CURSOR DN ...  ESC [ B
  4551.                      CURSOR LEFT ...  ESC [ C
  4552.                     CURSOR RIGHT ...  ESC [ D
  4553.  
  4554.     In addition, many ANSI escape sequences function slightly differently
  4555.     than in normal ANSI mode.  When in this mode, RIPterm tries to act
  4556.     like a VT-102 compatible terminal.
  4557.  
  4558.     The purpose of having this as a text variable is that the Host
  4559.     can instruct the terminal to enter this mode automatically, thus
  4560.     making it simpler on the user.
  4561.  
  4562.     -----------------------------------------------------------------
  4563.  
  4564.     $VT102OFF$ ... Turn VT-102 emulation mode OFF
  4565.  
  4566.     This variable disables the VT-102 mode, returning your
  4567.     keyboard to the standard keyboard operation.
  4568.  
  4569.     -----------------------------------------------------------------
  4570.  
  4571.     $DWAYON$ ... Turn Doorway Mode ON
  4572.  
  4573.     This variable enabled Doorway Mode.  This is intended to be used
  4574.     by a Host system that wishes to take advantage of the Doorway
  4575.     mode available in Marshall Dudley's Doorway (tm) software
  4576.     package.
  4577.  
  4578.     -----------------------------------------------------------------
  4579.  
  4580.     $DWAYOFF$ ... Turn Doorway Mode OFF
  4581.  
  4582.     This variable disabled the Doorway keyboard mode.  This will
  4583.     return the keyboard to normal operation.
  4584.  
  4585.     -----------------------------------------------------------------
  4586.  
  4587.     $SAVE$ ... Save graphics screen
  4588.  
  4589.     The SAVE variable will completely save the contents of the entire
  4590.     graphics screen to a disk file called RIPTERM.SAV.  No Mouse
  4591.     Fields, Text Window locations or Clipboard data are saved - just
  4592.     the graphics screen.  The entire 640x350 region is saved to disk.
  4593.  
  4594.     If you wish to save the entire state of the RIPterm system, use
  4595.     the following text variables all at the same time (spaces are
  4596.     added for clarity):
  4597.  
  4598.               $SAVE$ $STW$ $SCB$ $SMF$
  4599.                  \     \     \     \
  4600.                   \     \     \     --- Save Mouse Fields
  4601.                    \     \     \
  4602.                     \     \     ------- Save ClipBoard
  4603.                      \     \
  4604.                       \     ----------- Save Text Window
  4605.                        \
  4606.                         --------------- Save Graphics Screen
  4607.  
  4608.  
  4609.     -----------------------------------------------------------------
  4610.  
  4611.     $RESTORE$ ... Restore graphics screen
  4612.  
  4613.     The RESTORE command will read the saved file RIPTERM.SAV in from
  4614.     disk and restore the graphics as they were originally saved with
  4615.     the $SAVE$ command.  Only the graphics screen is restored, not
  4616.     the Clipboard, Mouse Fields or Text Window settings.  To restore
  4617.     the entire context of the graphics environment, issue the
  4618.     following text variables:
  4619.  
  4620.               $RESTORE$ $STW$ $SCB$ $SMF$
  4621.                  \        \     \     \
  4622.                   \        \     \     --- Restore Mouse Fields
  4623.                    \        \     \
  4624.                     \        \     ------- Restore ClipBoard
  4625.                      \        \
  4626.                       \        ----------- Restore Text Window
  4627.                        \
  4628.                         ------------------ Restore Graphics Screen
  4629.  
  4630.     -----------------------------------------------------------------
  4631.  
  4632.     $SAVE0$-$SAVE9$ & $RESTORE0$-$RESTORE9$ ... Save/Restore screens
  4633.  
  4634.     These ten text variables are identical in nature with $SAVE$
  4635.     described above with sole exception to the fact that the temp
  4636.     files (RIPTERM0.SAV - RIPTERM9.SAV) are immediately deleted
  4637.     when restored.  The $SAVE$ and $RESTORE$ commands do not do this.
  4638.     With this, you can keep restoring screens if you use $SAVE$.
  4639.     These ten variables are provided so that you can have more than
  4640.     one screen saved simultaneously.
  4641.  
  4642.     -----------------------------------------------------------------
  4643.  
  4644.     $HKEYON$ ... Enable Button Hotkeys
  4645.  
  4646.     This option enables button hotkeys.  Any Button that is created
  4647.     by a BBS that has a hotkey will be activated if you hit the
  4648.     corresponding key on your keyboard.  This will light-up the
  4649.     Scroll-Lock key on your keyboard indicating that Button Hotkey
  4650.     mode is ON.
  4651.  
  4652.     -----------------------------------------------------------------
  4653.  
  4654.     $HKEYOFF$ ... Disable Button Hotkeys
  4655.  
  4656.     This option disables button hotkeys.  Any Button that is created
  4657.     by a BBS that has a hotkey associated with it, will not be
  4658.     activated even if the user hits that key on his keyboard.  The
  4659.     only way to activate a button in this mode is with the mouse.
  4660.     The Scroll-Lock key on your keyboard will go dim, indicating
  4661.     that Button Hotkey Mode is disabled.
  4662.  
  4663.     -----------------------------------------------------------------
  4664.  
  4665.     $TABON$ ... Enable TAB to execute mouse fields
  4666.  
  4667.     When this variable is processed, you can use the TAB key to
  4668.     navigate through the Mouse/Button fields on your screen.  In
  4669.     this mode, you can access the fields without a mouse.  The side-
  4670.     effect is that the TAB key cannot be used directly with the Host.
  4671.  
  4672.     -----------------------------------------------------------------
  4673.  
  4674.     $TABOFF$ ... Disable TAB to execute mouse fields
  4675.  
  4676.     When this variable is processed, you cannot use the TAB key to
  4677.     navigate throug the Mouse/Button fields on your screen.  In this
  4678.     mode, whenever the TAB key is hit, it is sent directly to the
  4679.     Host as a TAB character.  Any fields that are already hilighted
  4680.     when this variable is received will be de-hilighted.
  4681.  
  4682.     -----------------------------------------------------------------
  4683.  
  4684.     $SAVEALL$ ... Performs the following: SAVE STW SCB and SMF
  4685.  
  4686.     This command combines a number of other "save" commands together
  4687.     into one short, quick command.  This command combines the
  4688.     $SAVE$, $STW$, $SCB$ and $SMF$ commands into one command.
  4689.  
  4690.     -----------------------------------------------------------------
  4691.  
  4692.     $RESTOREALL$ ... Performs the following: RESTORE RTW RCB and RMF
  4693.  
  4694.     This command combines a number of other "restore" commands together
  4695.     into one short, quick command.  This command combines the
  4696.     $RESTORE$, $RTW$, $RCB$ and $RMF$ commands into one command.
  4697.  
  4698.     -----------------------------------------------------------------
  4699.  
  4700.     $RESET$ ... Resets the screen (like ALT-R in RIPterm)
  4701.  
  4702.     This command performs a RIP_RESET_WINDOWS command to clear the
  4703.     screen and otherwise reset the GUI environment.  Be sure to
  4704.     be aware of when this is used from within a Mouse Field/Button!
  4705.  
  4706.  
  4707. ┌────────────────────────────────────────────────────────────────────┐
  4708. │        7.4.2.4 ■ SPECIAL TEXT VARIABLES - LOCAL RIP PLAYBACK       │
  4709. └────────────────────────────────────────────────────────────────────┘
  4710.  
  4711. You can re-play a .RIP file that you have locally on your hard disk
  4712. from a keystroke macro easily.  The format of the variable is
  4713. somewhat different than user variables, or pre-defined text
  4714. variables.  After the initial dollar sign ($), enter the greater-than
  4715. symbol (>) followed by the filename (with or without the .RIP
  4716. extension), then ending in another dollar sign ($).  Several examples
  4717. of this are as follows:
  4718.  
  4719.     $>MYFILE.RIP$
  4720.     $>FILE1$
  4721.     $>FILE1.RIP$$>FILE2.RIP$$FILE3$
  4722.  
  4723. When loaded, the data is not sent to the host; it is strictly echoed
  4724. on your local screen.  If the file is a .RIP file, it will replay any
  4725. graphics that were in the file and if any Mouse Regions are defined,
  4726. it will create those fields for you as well, thus allowing you to
  4727. pop-up dialog screens or other such things that are not built-in to
  4728. RIPterm normally.
  4729.  
  4730. Each "local RIP playback" variable you enter will search for the .RIP
  4731. file in the current host's icon directory.  If it cannot find the
  4732. file in that directory, it will check the ICONS\ directory.
  4733.  
  4734. If you have RIPaint, you could conceivably use this mode to place a
  4735. dialog box on your screen allowing you to alter your modems setup
  4736. quickly with your mouse, dial particular phone numbers or other such
  4737. things.
  4738.  
  4739.  
  4740. ┌────────────────────────────────────────────────────────────────────┐
  4741. │                        7.4.3 ■ POP-UP LISTS                        │
  4742. └────────────────────────────────────────────────────────────────────┘
  4743.  
  4744. In your keystroke macros you can take advantage of a unique feature
  4745. of RIPterm - popup pick-lists.  A popup pick-list is simply a list
  4746. that pops up allowing you to choose from one of several available
  4747. values.  Whichever entry in the list you choose will be inserted into
  4748. your keystroke macro in place of the list definition.
  4749.  
  4750. In order to use popup pick-lists in your keystroke macros, you must
  4751. define the list in the text of your macro.
  4752.  
  4753. A list is created by putting the special list instructions inside of
  4754. two parenthesis (( and )).  The list instructions consist of an
  4755. optional question, followed by one or more entries to put in the
  4756. List.  For example, ((Send E-Mail to?::Sysop,Cosysop,Joe)) says to
  4757. Pop-Up a list asking you "Send E-Mail to?", giving you the choices of
  4758. "Sysop", "Cosysop", and "Joe".
  4759.  
  4760. By default, if you press <ESCAPE> instead of picking an entry in the
  4761. list, then nothing will be inserted into the text of your macro.  You
  4762. can indicate that the user MUST pick an entry by putting an asterisk
  4763. (*) at the beginning of the question.  For example, ((*Send Mail
  4764. to?::Sysop,Joe)).  This would make it so that the User MUST choose
  4765. either SYSOP or JOE.
  4766.  
  4767. In the previous examples, SYSOP, COSYSOP and JOE are the text
  4768. responses that are inserted into your macros.  These commands are
  4769. also the same things that are displayed in the listing.  If you want
  4770. to use something else instead of the "return text", you can.  When
  4771. you enter the list entry, add an @description to the end of it.
  4772.  
  4773.     Example: ((Send Mail To?::Sysop@The Head Honcho,Cosysop,Joe))
  4774.  
  4775. One final feature of popup pick-lists allow you to specify a hotkey
  4776. for each entry in the list.  For example, if you wanted the first
  4777. character of each entry to be highlighted (thus allowing you to
  4778. select that character to activate the entry), simply put a tilde (~)
  4779. or an underline (_) before and after the keystroke.  For example
  4780. "_S_ysop" would highlight the "S" in "Sysop".  You can highlight more
  4781. than one character, but only the first one will be the active
  4782. hotkey.  If you omit the second tilde or underline, then the
  4783. remainder of the description will be highlighted.
  4784.  
  4785. NOTE: If you use a tilde or an underline in the text response command
  4786.       (not the description), then those characters will be
  4787.       automatically inserted into your macro when it gets transmitted
  4788.       to the host.  This is probably not what you would want to do.
  4789.       Bottom line, only use hotkey features on list entries where you
  4790.       specify a description!
  4791.  
  4792. If you do not specify a question, then the list will ask you:
  4793. "Choose one of the following:"
  4794.  
  4795. You may specify up to twenty list entries for any one list.
  4796.  
  4797. Examples:
  4798.  
  4799.     ((Send E-Mail to?::Sysop,Joe,Mike))
  4800.     ((*Send E-Mail to?::Sysop@The Head Honcho,Joe,Mike@My Brother))
  4801.     ((::Sysop@_T_he Head Honcho,Joe,Mike@My _B_rother))
  4802.     ((Sysop,Joe,Mike,George))
  4803.  
  4804.  
  4805. ╔════════════════════════════════════════════════════════════════════╗
  4806. ║                    8.0 ■ ONLINE DEMONSTRATIONS                     ║
  4807. ╚════════════════════════════════════════════════════════════════════╝
  4808.  
  4809. If you would like to see an example of RIPscrip graphics in action,
  4810. you may log-on to one of the following hosts free of charge:
  4811.  
  4812. ┌──────────────────────────────────────────────────────────────┐
  4813. │ 1. ArenaBBS - 32 lines, Galacticomm "The Major BBS" software │
  4814. │    This is TeleGrafix's Tech Support/Entertainment BBS       │
  4815. └──────────────────────────────────────────────────────────────┘
  4816.  
  4817.     PHONE: (714) 379-2133
  4818.  
  4819.     > Create an account for yourself on the system by
  4820.     > typing "NEW" at the log-on prompt.  Answer the
  4821.     > questionnaire and at the main menu, type "RIP ON".
  4822.     > Press <ENTER> to redisplay the menu & away
  4823.     > you go!  This is a subscription service, but you do
  4824.     > not need to subscribe to see an on-line demonstration.
  4825.     > If you discover that your icon files are out of date,
  4826.     > send E-mail to SYSOP or download the file ARENAICN.ZIP
  4827.     > from the RIPICONS file library section.
  4828.  
  4829. ┌──────────────────────────────────────────────────────────────┐
  4830. │ 2. Nova Central - 4 lines, ResNova "Nova Link Professional"  │
  4831. │    This is ResNova's Technical Support BBS                   │
  4832. └──────────────────────────────────────────────────────────────┘
  4833.  
  4834.     PHONE: (714) 379-9004
  4835.  
  4836.     > This is ResNova's technical support BBS.  It is using
  4837.     > the Nova Link Professional host for the Apple
  4838.     > Macintosh.  Simply sign-up on the system and at the
  4839.     > Main Menu, choose the "RIPscrip Graphics" option
  4840.     > for an on-line demonstration.
  4841.  
  4842. ┌──────────────────────────────────────────────────────────────┐
  4843. │ 3. RIP Demo Midwest - 2 line TBBS system.  This BBS is a     │
  4844. │    full RIP Demo System.                                     │
  4845. └──────────────────────────────────────────────────────────────┘
  4846.  
  4847.     PHONE: (708) 978-2777
  4848.  
  4849.     > Sign-up in "text mode" if you do not have the RDM
  4850.     > icons.  Download the system icons and away you
  4851.     > go.  Be sure to see the Message Forums and other areas.
  4852.  
  4853. ┌──────────────────────────────────────────────────────────────┐
  4854. │ 4. Galacticomm BBS -- The Major BBS' headquarters BBS        │
  4855. └──────────────────────────────────────────────────────────────┘
  4856.  
  4857.     PHONE: (305) 583-7808
  4858.  
  4859.     > Home of the RIPscrip Add-On for Major BBS
  4860.  
  4861. ┌──────────────────────────────────────────────────────────────┐
  4862. │ 5. Searchlight BBS -- Headquarters BBS for Searchlight BBS   │
  4863. └──────────────────────────────────────────────────────────────┘
  4864.  
  4865.     PHONE: (516) 689-2566
  4866.  
  4867.     > Author of RIP compatible Searchlight BBS
  4868.     > Also the authors of the RIPscrip Puzzle games
  4869.  
  4870. ┌──────────────────────────────────────────────────────────────┐
  4871. │ 6. Wildcat BBS ------ Mustang Software's Wildcat HQ BBS      │
  4872. └──────────────────────────────────────────────────────────────┘
  4873.  
  4874.     PHONE: (805) 395-0250
  4875.  
  4876.     > Authors of QmodemPro and Wildcat BBS
  4877.  
  4878. ┌──────────────────────────────────────────────────────────────┐
  4879. │ 7. Synchronet BBS --- Digital Dynamics Synchronet HQ BBS     │
  4880. └──────────────────────────────────────────────────────────────┘
  4881.  
  4882.     PHONE: (714) 529-9547
  4883.  
  4884.     > Authors of Synchronet BBS
  4885.  
  4886. ┌──────────────────────────────────────────────────────────────┐
  4887. │ 8. Solaris BBS ------ Headquarters BBS for Solaris BBS       │
  4888. └──────────────────────────────────────────────────────────────┘
  4889.  
  4890.     PHONE: +49-241-156071
  4891.  
  4892.     > German: Authors of Solaris BBS
  4893.  
  4894.  
  4895. ╔════════════════════════════════════════════════════════════════════╗
  4896. ║               APPENDIX A ■ TROUBLESHOOTING/PROBLEMS                ║
  4897. ╚════════════════════════════════════════════════════════════════════╝
  4898.  
  4899. Modem communications is not a simple thing.  There are many different
  4900. technical factors that can affect RIPterm, making it work
  4901. erratically, or unreliably.  This section is intended to try to help
  4902. you figure out what's wrong and get yourself up and running as
  4903. quickly as possible.
  4904.  
  4905. Check through the remainder of this section to see if the particular
  4906. problem you're having is addressed.  If you are having some sort of
  4907. difficulty not covered below (or the instructions that follow do not
  4908. resolve the problem), contact the TeleGrafix Technical Support
  4909. department as noted in APPENDIX B.
  4910.  
  4911.  
  4912. ┌────────────────────────────────────────────────────────────────────┐
  4913. │                   A.1 ■ "BUS" MOUSE DOESN'T WORK                   │
  4914. └────────────────────────────────────────────────────────────────────┘
  4915.  
  4916. Make sure your mouse driver is loaded into memory before you run
  4917. RIPterm.  Without a mouse driver loaded, RIPterm will not be able to
  4918. use your mouse.  Consult the manual that came with your mouse under
  4919. the section INSTALLATION or SOFTWARE INSTALLATION.
  4920.  
  4921. Most mouse drivers come in two flavors, a .SYS file, or a TSR program
  4922. ending in a .COM file extension.  A .SYS file must be loaded into
  4923. your C:\CONFIG.SYS file as any other device driver.
  4924.  
  4925. An example of loading your MOUSE.SYS driver would be as follows:
  4926.  
  4927.  
  4928.     CONFIG.SYS file:
  4929.  
  4930.         FILES=40
  4931.         BUFFERS=40
  4932.         DEVICE=C:\MOUSE\MOUSE.SYS
  4933.  
  4934. If your mouse came only with a MOUSE.COM driver, then you must edit
  4935. your C:\AUTOEXEC.BAT file and add a line calling mouse driver so that
  4936. it can be loaded into memory each time your system boots up.  Add a
  4937. line similar to the one that follows:
  4938.  
  4939.     AUTOEXEC.BAT file:
  4940.  
  4941.         PATH=C:\;C:\DOS;C:\MOUSE
  4942.         PROMPT $P$G
  4943.         MOUSE
  4944.  
  4945. Modifications may vary - consult your Mouse Manual.
  4946.  
  4947.  
  4948. ┌────────────────────────────────────────────────────────────────────┐
  4949. │                 A.2 ■ "SERIAL" MOUSE DOESN'T WORK                  │
  4950. └────────────────────────────────────────────────────────────────────┘
  4951.  
  4952. If you are using a serial mouse, and it is not responding, you might
  4953. be experiencing a "conflict" between your modem serial port, and your
  4954. mouse serial port.  Under most circumstances, a conflict like this
  4955. will NOT arise in normal applications programs that don't use both a
  4956. mouse and a modem simultaneously.
  4957.  
  4958. Below you should find a list of correct and incorrect modem/mouse
  4959. configurations.
  4960.  
  4961.     CORRECT COMBINATIONS        INCORRECT COMBINATIONS
  4962.     =======================     =======================
  4963.     Modem=COM1 / Mouse=COM2     Modem=COM1 / Mouse=COM3
  4964.     Modem=COM1 / Mouse=COM4     Modem=COM2 / Mouse=COM4
  4965.     Modem=COM2 / Mouse=COM1     Modem=COM3 / Mouse=COM1
  4966.     Modem=COM2 / Mouse=COM3     Modem=COM4 / Mouse=COM2
  4967.     Modem=COM3 / Mouse=COM2
  4968.     Modem=COM3 / Mouse=COM4
  4969.     Modem=COM4 / Mouse=COM1
  4970.     Modem=COM4 / Mouse=COM3
  4971.  
  4972. If you are knowledgeable about IBM-PC hardware, and how to install
  4973. add-on cards, you may be able to circumvent the above recommended
  4974. port combinations.  To do this will require removing the PC cover and
  4975. changing the interrupt (IRQ) setting of either the modem serial port,
  4976. or the mouse serial port (if possible).  In order to get both the
  4977. mouse and the modem operating properly, the two serial ports must use
  4978. different IRQ settings!  If none of this makes sense to you, we would
  4979. recommend sticking to the above recommended layouts.
  4980.  
  4981.  
  4982. ┌────────────────────────────────────────────────────────────────────┐
  4983. │                    A.3 ■ MODEM ISN'T RESPONDING                    │
  4984. └────────────────────────────────────────────────────────────────────┘
  4985.  
  4986. If you have a serial mouse, you may be experiencing a conflict
  4987. between your mouse and your modem.  A serial mouse can be identified
  4988. if it plugs into one of your IBM-PC communications ports COM1 through
  4989. COM4.  Not all systems have 4 COM ports, so your system may be
  4990. somewhat different.  A serial mouse typically has a 25-pin connector
  4991. shaped like an elongated "D".  Another type of serial mouse has a
  4992. 9-pin connector also shaped like a "D".
  4993.  
  4994. Check to make sure you modem is plugged in and turned on (if it is an
  4995. external modem).  Make sure that the serial cable connecting the
  4996. modem to your computer is securely fastened to the proper COM port.
  4997.  
  4998. Check your modem settings to make sure they are set correctly.  You
  4999. may edit these settings by pressing ALT-O (Modem Options).  Things
  5000. you should check for:
  5001.  
  5002.     1.  Make sure it is set for the correct port (COM1 - COM4)
  5003.  
  5004.     2.  Make sure the baud rate is set to a speed your modem
  5005.         can support (or lower).  Settings for this would be
  5006.         300, 1200, 2400, 9600, 19,200 baud.
  5007.  
  5008. Consult SECTION 4.1 above to determine if you are using an
  5009. incorrect COM port configuration for your serial mouse and your
  5010. modem.
  5011.  
  5012.  
  5013. ┌────────────────────────────────────────────────────────────────────┐
  5014. │                 A.4 ■ NOISY TELEPHONE CONNECTIONS                  │
  5015. └────────────────────────────────────────────────────────────────────┘
  5016.  
  5017. If you get a noisy telephone connection, the graphics that you see
  5018. might become garbled in some fashion.  Since RIPterm does more than
  5019. simply display pictures on the screen, this can disturb underlying
  5020. (invisible) operations as well.
  5021.  
  5022. Solutions:  Hang-up and try calling again.  Often times, this can
  5023.             resolve the problem.
  5024.  
  5025.             Long distance connections are typically the noisiest
  5026.             connections.  Check with your operator and find out if
  5027.             you can use a different "Long Distance Carrier" like MCI,
  5028.             AT&T, US Sprint, etc.
  5029.  
  5030.             Use an Error-Correcting modem (provided the host you are
  5031.             calling can support one).
  5032.  
  5033.  
  5034. ╔════════════════════════════════════════════════════════════════════╗
  5035. ║                APPENDIX B ■ Supported ANSI Sequences               ║
  5036. ╚════════════════════════════════════════════════════════════════════╝
  5037.  
  5038.    ESC [ !               ... Auto-Sense RIPscrip terminal
  5039.    ESC [ 0 !             ... Auto-Sense RIPscrip terminal
  5040.    ESC [ 1 !             ... Disable RIPscrip processing
  5041.    ESC [ 2 !             ... Enable  RIPscrip processing
  5042.    ESC [ Pn @            ... Insert Pn spaces at cursor position
  5043.    ESC [ Pn P            ... Delete Pn characters at cursor position
  5044.    ESC [ Pn ; Ln P       ... Doorway Mode - Print Ln chars to LPT (Pn)
  5045.                              NOTE: LPT (Pn) is ignored.
  5046.    ESC [ Pn L            ... Insert Pn lines at cursor position
  5047.    ESC [ Pn M            ... Delete Pn lines at cursor position
  5048.    ESC [ Pn A            ... Move cursor up Pn lines (no scrolling)
  5049.    ESC [ Pn B            ... Move cursor down Pn lines (no scrolling)
  5050.    ESC [ Pn D            ... Move cursor left Pn columns (no wrapping)
  5051.    ESC [ Pn C            ... Move cursor right Pn columns (no wrapping)
  5052.    ESC [ Pn Z            ... Performs a Backtab Pn times
  5053.    ESC [ An ; Fn ; Bn m  ... Display Attributes
  5054.    ESC [ J               ... Clear screen from cursor to LR of screen
  5055.    ESC [ 0 J             ... Same as ESC [ J
  5056.    ESC [ 1 J             ... Clear screen from cursor to UL of screen
  5057.    ESC [ 2 J             ... Clears the entire screen & homes cursor
  5058.    ESC [ K               ... Clear to end of line
  5059.    ESC [ 0 K             ... Same as ESC [ K
  5060.    ESC [ 1 K             ... Clear from beginning of line to cursor
  5061.    ESC [ 2 K             ... Clears entire line - leave cursor alone
  5062.    ESC [ g               ... Clear tab stop at current cursor position
  5063.    ESC [ 0 g             ... Same as ESC [ g
  5064.    ESC [ 3 g             ... Clears all tab stops
  5065.    ESC [ Py ; Px H       ... Move cursor to (Px,Py)
  5066.    ESC [ Py ; Px f       ... Move cursor to (Px,Py)
  5067.    ESC [ s               ... Saves current cursor position
  5068.    ESC [ u               ... Restores saved cursor position
  5069.    ESC [ 5 n             ... Device status report - returns ESC [ 0 n
  5070.    ESC [ 6 n             ... Device status report - returns cursor pos
  5071.                              as ESC [ y ; x R
  5072.    ESC [ c               ... Device attribute report
  5073.    ESC [ Pl ; Pn r       ... Set scrolling region between lines Pl - Pn
  5074.    ESC [ S               ... Scrolls the screen UP one line
  5075.    ESC [ ? 6 l           ... Sets Home Position to UL of screen
  5076.    ESC [ ? 7 l           ... Sets line character wrapping OFF
  5077.    ESC [ ? 15 n          ... Device status report - reports NO printer
  5078.    ESC [ ? 7 h           ... Sets line character wrapping ON
  5079.    ESC 7                 ... Saves current cursor position
  5080.    ESC 8                 ... Restores saved cursor position
  5081.    ESC c                 ... Reset terminal emulation to initial state
  5082.    ESC Z                 ... Same as ESC [ c
  5083.    ESC D                 ... Cursor DOWN (scroll if at bottom)
  5084.    ESC E                 ... Cursor to next line (column #1) w/ scroll
  5085.    ESC M                 ... Move cursor UP (scroll if at top)
  5086.    ESC H                 ... Set Tab Stop at current column
  5087.    ESC ( A               ... Selects UK character set as G0
  5088.    ESC ( B               ... Selects US character set as G0
  5089.    ESC ( 0               ... Selects line drawing character set as G0
  5090.    ESC ) A               ... Selects UK character set as G1
  5091.    ESC ) B               ... Selects US character set as G1
  5092.    ESC ) 0               ... Selects line drawing character set as G1
  5093.    ESC [ = 255 h         ... Doorway mode: Enter doorway mode
  5094.    ESC [ = 255 l         ... Doorway mode: Exit doorway mode
  5095.  
  5096.  
  5097. ╔════════════════════════════════════════════════════════════════════╗
  5098. ║                   APPENDIX C ■ TECHNICAL SUPPORT                   ║
  5099. ╚════════════════════════════════════════════════════════════════════╝
  5100.  
  5101. This program is as bug-free as possible.  In all reality, there are
  5102. most likely some bugs that have not as of yet been discovered.
  5103. Should any bugs be discovered, they should be reported to the authors
  5104. as soon as possible at the following address:
  5105.  
  5106.           ┌───────────────────────────────────────────────┐
  5107.           │        TeleGrafix Communications, Inc.        │
  5108.           │            16458 Bolsa Chica #15              │
  5109.           │          Huntington Beach, CA 92649           │
  5110.           │                                               │
  5111.           │ Voice .. (714) 379-2131                       │
  5112.           │ Fax .... (714) 379-2132                       │
  5113.           │ Data ... (714) 379-2133 - ArenaBBS [32 lines] │
  5114.           └───────────────────────────────────────────────┘
  5115.  
  5116.    Authors: Jeff "Covenant" Reeder
  5117.             (CEO: Senior Programmer)
  5118.  
  5119.             Mark "Necron" Hayton
  5120.             (President: Programmer)
  5121.  
  5122.             Jim "Bergie" Bergman
  5123.             (Vice President: Programmer)
  5124.  
  5125.             Mara "Kytty" Ward
  5126.             (Chief Operations Officer: Production)
  5127.  
  5128.  
  5129. ╔════════════════════════════════════════════════════════════════════╗
  5130. ║                   APPENDIX D ■ RIPscrip Products                   ║
  5131. ╚════════════════════════════════════════════════════════════════════╝
  5132.  
  5133. For more information about RIPscrip based products, contact:
  5134.  
  5135.     TeleGrafix Communications, Inc.
  5136.     16458 Bolsa Chica, #15
  5137.     Huntington Beach, CA 92649
  5138.  
  5139.     Voice: (714) 379-2131
  5140.     Fax  : (714) 379-2132
  5141.     Data : (714) 379-2133 ArenaBBS [32 lines] running The Major BBS
  5142.  
  5143.